FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

[Docs] Deprecation policy, SDK tier target, and CONTRIBUTING.md by chr-hertel · Pull Request #472 · modelcontextprotocol/php-sdk · GitHub

Repository navigation

[Docs] Deprecation policy, SDK tier target, and CONTRIBUTING.md - #472

Merged
chr-hertel merged 10 commits into
modelcontextprotocol:mainfrom
chr-hertel:docs/lifecycle-tier-and-contributing
Aug 23, 2026
Merged

chr-hertel merged 10 commits into
modelcontextprotocol:mainfrom
chr-hertel:docs/lifecycle-tier-and-contributing

Conversation

Copy link
Copy Markdown
Member

Summary

Test plan

  • make docs-guides (Zensical --strict build) — no issues found
  • vendor/bin/phpstan analyse — no errors
  • vendor/bin/php-cs-fixer fix --dry-run --diff — 0 files need fixing

Formalizes the Active -> Deprecated -> Removed lifecycle and the
twelve-month deprecation window the SDK already applies via SEP-2577,
and states the SDK's own BC promise ahead of 1.0.
Adds both pages under a new Project section in mkdocs.yml, links them
from index.md's "Where to go next", and points their repo-root
references at GitHub URLs instead of paths escaping docs/ (dead under
Zensical's --strict build).
Root-level contribution guide: dev setup, the make ci checks to run
before a PR, coding standards, testing expectations, the docs-guide
link-resolution rule Zensical enforces, and licensing terms. Linked
from README's existing Contributing section.
Comment thread docs/deprecation-policy.md Outdated
Comment thread docs/deprecation-policy.md Outdated
Comment thread docs/deprecation-policy.md Outdated
Drop the worked SEP-2577 example and the "relationship to the
protocol lifecycle" section; both were redundant restating of detail
that lives in the code/CHANGELOG and protocol-versions.md already.
Replace our own hand-rolled conformance numbers with the authoritative
audit in modelcontextprotocol/modelcontextprotocol#3274: SDK is
currently Tier 3, blocked from Tier 2 by client OAuth conformance
(20%) and no stable 1.0.0+ release. Add the Versioning section the
audit found missing — SemVer commitment pre-1.0, Symfony's BC promise
after — and point CONTRIBUTING.md at it.
Was plain text; sdk-tier.md's Versioning section already links it.
chr-hertel added the documentation Improvements or additions to documentation label Aug 22, 2026
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
chr-hertel merged commit 1e9520e into modelcontextprotocol:main Aug 23, 2026
27 checks passed
chr-hertel deleted the docs/lifecycle-tier-and-contributing branch August 23, 2026 23:23
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

1 participant


Back | FazBrowse Home | New Git URL