Skip to content

Commit 4cc69cc

Browse files
committed
updated language and format
1 parent 448526a commit 4cc69cc

3 files changed

Lines changed: 12 additions & 11 deletions

File tree

docs/community/feature-lifecycle.mdx

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,12 @@ again, the minimum deprecation window in
3737
revision in which the new deprecation takes effect.
3838

3939
### SDKs
40+
4041
Removal from the specification does not oblige an SDK to drop the feature from
4142
releases. That timeline is governed by the SDK's own revision-support policy.
4243

43-
4444
## Deprecating a Feature
45+
4546
A feature may be proposed for deprecation due to
4647

4748
- it has been superseded by another feature that covers the same use cases,
@@ -60,7 +61,7 @@ Deprecation is a specification change and therefore requires a SEP per the
6061
3. Document the migration path, or state explicitly that none is required. If
6162
the migration path names a replacement feature, that feature must be Active
6263
in the revision in which the deprecation takes effect; the replacement and
63-
the deprecation may land in the same revision.
64+
the deprecation may land in the same revision.
6465
4. Specify the **minimum deprecation window**: the number of months, at least
6566
twelve, that the feature must remain Deprecated before it is eligible for
6667
removal. The window is measured from the release of the specification
@@ -69,7 +70,7 @@ Deprecation is a specification change and therefore requires a SEP per the
6970
specification revision released as Current on or after the window elapses;
7071
that point is the feature's **earliest removal**.
7172

72-
When the deprecation SEP is accepted and reaches Final, the deprecation is scheduled.
73+
When the deprecation SEP is accepted and reaches Final, the deprecation is scheduled.
7374

7475
- The feature's entry in `schema.ts` gains a `@deprecated` JSDoc tag
7576
referencing the deprecation SEP and the revision in which the deprecation
@@ -86,15 +87,15 @@ When the deprecation SEP is accepted and reaches Final, the deprecation is sched
8687

8788
The feature becomes Deprecated when the revision carrying these changes is released
8889
and becomes the new Current revision (see [versioning guide](/docs/learn/versioning)).
89-
The minimum deprecation window is counted from that release.
90+
The minimum deprecation window is counted from that release.
9091

9192
## The Deprecated Registry
9293

9394
[`docs/specification/draft/deprecated.mdx`](/specification/draft/deprecated) is
9495
a single page listing every feature Deprecated or Removed state. It is
9596
the canonical answer to "what is on its way out, and by when," so that an
9697
implementer does not have to reconstruct that picture from deprecation entries
97-
spread across revision changelogs.
98+
spread across revision changelogs.
9899

99100
## Tier 1 SDK Obligations
100101

@@ -105,18 +106,18 @@ released as Current, Tier 1 SDKs:
105106
native mechanism (for example `@Deprecated` in Java, `[Obsolete]` in .NET,
106107
`@deprecated` JSDoc in TypeScript, the `Deprecated:` doc convention in Go) in
107108
their next release, referencing the deprecation SEP and the earliest removal
108-
date where the mechanism permits.
109+
date where the mechanism permits.
109110
- Should emit a runtime warning when a deprecated feature is exercised, using
110111
the language's idiomatic mechanism (for example Python's
111112
`DeprecationWarning`, Node.js's `process.emitWarning`, or a configurable
112-
logger).
113+
logger).
113114

114115
## Removing a Feature
115116

116117
1. Once a feature is set for removal, the removal is executed at the discretion
117118
of the Core Maintainers after the minimum deprecation window has elapsed.
118119
2. The removal needs to be documented in the `changelog.mdx` and [registry](#the-deprecated-regsitry)
119-
2. A SEP is required for any change to the original deprecation or removal SEP, for
120+
3. A SEP is required for any change to the original deprecation or removal SEP, for
120121
example extending or shortening the timeline
121122
([Expedited removal](#expedited-removal)) or restoring the feature to Active
122123
([Feature states](#feature-states)).

docs/specification/draft/basic/lifecycle.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,6 @@ extension identifiers to per-extension settings objects.
133133
The following is an example of a client that advertises the
134134
[MCP Apps extension](/extensions/apps/overview) identified as `io.modelcontextprotocol/ui`:
135135

136-
137136
```json
138137
{
139138
"capabilities": {
@@ -148,6 +147,7 @@ The following is an example of a client that advertises the
148147
```
149148

150149
An example of [Tasks extension](/extensions/tasks/overview) identified as `io.modelcontextprotocol/tasks`:
150+
151151
```json
152152
{
153153
"capabilities": {

docs/specification/draft/basic/transports.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -698,8 +698,8 @@ See [Lifecycle: Backward Compatibility][lifecycle-compat] for details.
698698

699699
#### Earlier Streamable HTTP Revisions
700700

701-
Protocol versions `2025-03-26` through `2025-11-25` also used the Streamable
702-
HTTP transport, but in a different shape: servers could assign a session via
701+
Protocol versions `2025-03-26` through [`2025-11-25`](./docs/specification/2025-11-25/basic/transports.mdx)
702+
also used the Streamable HTTP transport, but in a different shape: servers could assign a session via
703703
the `Mcp-Session-Id` header (terminated with HTTP DELETE), clients could open
704704
a standalone SSE stream with HTTP GET to receive server-initiated messages,
705705
servers could send JSON-RPC _requests_ on SSE streams, and streams were

0 commit comments

Comments
 (0)