Skip to content

Commit 3a6f6a6

Browse files
committed
docs: drop the 'Next:' course framing from the page-bottom hand-offs
Ten pages closed with a 'Next: ...' / '... is next' hand-off to the page that used to follow them in the retired linear read-through. The pointer and the link are worth keeping -- the word 'Next' is not: it tells a reader who arrived at one page from a search engine that they are on a course, which is exactly the tutorial framing this series of changes removes. Each hand-off keeps its full sentence and its link and loses only the sequencing word: Next: telling connected clients that something changed ... with [Subscriptions]. -> Telling connected clients that something changed ... is [Subscriptions]. The one 'Next:' inside Get started (first-steps.md) is deliberately untouched: that section IS a guided sequence, and there the word is correct.
1 parent 171971e commit 3a6f6a6

10 files changed

Lines changed: 10 additions & 10 deletions

File tree

docs/client/callbacks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,4 +144,4 @@ Two more. Neither declares anything.
144144
* `sampling_callback` and `list_roots_callback` work the same way but serve deprecated features; modern servers use multi-round-trip requests instead.
145145
* `logging_callback` and `message_handler` receive notifications. They declare nothing.
146146

147-
Next: the first argument you've been passing to `Client(...)` all along, **[Client transports](transports.md)**.
147+
The first argument to `Client(...)` is a transport object — **[Client transports](transports.md)** covers every kind.

docs/client/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,4 +209,4 @@ There is one constructor flag built for that: `Client(mcp, raise_exceptions=True
209209
* `list_resources` / `list_resource_templates` / `read_resource`, `list_prompts` / `get_prompt`, and `complete` round out the verbs.
210210
* Every `list_*` takes `cursor=`; loop until `next_cursor` is `None`.
211211

212-
Next: the things a server can ask the *client* for, and how you answer, in **[Client callbacks](callbacks.md)**.
212+
The things a server can ask the *client* for, and how you answer them, are **[Client callbacks](callbacks.md)**.

docs/handlers/context.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,4 +126,4 @@ On a 2026-07-28 connection, clients receive change notifications only on a `subs
126126
* `ctx.session` is the channel back to the client: `send_tool_list_changed()` and its siblings tell it to re-fetch a list you changed.
127127
* Progress reporting and elicitation also start at `Context`; each has its own page.
128128

129-
Next: parameters the model never sees, filled by your own functions, in **[Dependencies](dependencies.md)**.
129+
Parameters the model never sees, filled by your own functions, are **[Dependencies](dependencies.md)**.

docs/handlers/dependencies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,4 +142,4 @@ That's the right default for a precondition: no answer, no order. When declining
142142
* Bad graphs fail at registration with `InvalidSignature`, not mid-call.
143143
* Return `Elicit(message, Model)` to ask the user, only when you have to. Unwrapped annotations abort on decline; `ElicitationResult[T]` lets the tool branch.
144144

145-
Next: state your server builds once at startup, and how a handler reaches it, in the **[Lifespan](lifespan.md)**.
145+
State your server builds once at startup, and how a handler reaches it, is the **[Lifespan](lifespan.md)**.

docs/handlers/lifespan.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,4 +99,4 @@ Strip the server down to the lifecycle: give `Database` a `connected` flag, flip
9999
* `ctx: Context[AppContext]` makes that access fully typed in tools. Resources and prompts take the bare `Context`.
100100
* No `lifespan=` means an empty `dict`, never `None`.
101101

102-
Next: a handler that stops mid-call to ask the user for something only they know, in **[Elicitation](elicitation.md)**.
102+
A handler that stops mid-call to ask the user for something only they know is **[Elicitation](elicitation.md)**.

docs/handlers/logging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,4 +75,4 @@ went to standard error: the terminal, not the wire.
7575
* Standard error is yours; stdout belongs to the protocol. Never `print()` in a stdio server.
7676
* `MCPServer(..., log_level="DEBUG")` sets the level, and a logging configuration you made first is left alone.
7777

78-
Next: telling connected clients that something on your server changed — the tool list, a resource — with **[Subscriptions](subscriptions.md)**.
78+
Telling connected clients that something on your server changed — the tool list, a resource — is **[Subscriptions](subscriptions.md)**.

docs/handlers/progress.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,4 +114,4 @@ The callback receives `total=None`. A client can still show *activity* ("3 impor
114114
* No callback on the call means `report_progress` does nothing. Report unconditionally.
115115
* Omit `total` when you don't know it; the callback gets `None`.
116116

117-
Progress is what a running tool shows the *user*. The lines it logs for *you*, the person operating the server, are a different channel: **[Logging](logging.md)** is next.
117+
Progress is what a running tool shows the *user*. The lines it logs for *you*, the person operating the server, are a different channel: **[Logging](logging.md)**.

docs/servers/completions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,4 +122,4 @@ Drop `context_arguments=` and the same call returns `[]`. The handler can't know
122122
* `context.arguments` holds the already-resolved values; the client supplies them as `context_arguments=`.
123123
* The `completions` capability appears the moment you register the handler. Without it, the request is `Method not found`.
124124

125-
Suggestions help while the user is still *filling in* a prompt or template; to ask them a question in the *middle* of a tool call, you want **[Elicitation](../handlers/elicitation.md)**. Next: everything a tool can return besides text, in **[Images, audio & icons](media.md)**.
125+
Suggestions help while the user is still *filling in* a prompt or template; to ask them a question in the *middle* of a tool call, you want **[Elicitation](../handlers/elicitation.md)**. Everything a tool can return besides text is **[Images, audio & icons](media.md)**.

docs/servers/prompts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,4 +147,4 @@ The `prompts/list` entry now carries everything a client needs to draw a good fo
147147
* `title=` and `Field(description=...)` are what a client puts in its UI.
148148
* A missing required argument fails the whole request. There is no per-prompt error result.
149149

150-
Next up: server-side autocomplete for a prompt's (or a resource template's) arguments, in **[Completions](completions.md)**.
150+
Server-side autocomplete for a prompt's (or a resource template's) arguments is **[Completions](completions.md)**.

docs/servers/tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -169,4 +169,4 @@ A well-behaved client uses them to decide things like *"do I need to ask the use
169169
* Bad arguments are rejected for you, with an error the model can read and recover from.
170170
* `async def` for I/O, plain `def` for everything else.
171171

172-
Next up, **[Structured Output](structured-output.md)**: what happens to the value you `return`.
172+
**[Structured Output](structured-output.md)** is what happens to the value you `return`.

0 commit comments

Comments
 (0)