Skip to content

Commit 389d193

Browse files
dsp-antdsp-ant
authored
Merge pull request modelcontextprotocol#770 from jonathanhefner/rework-docs-navigation
Rework docs navigation
2 parents 92ec656 + 655daa7 commit 389d193

File tree

13 files changed

+258
-102
lines changed

13 files changed

+258
-102
lines changed

‎docs/development/contributing.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ title: Contributing
33
description: How to participate in Model Context Protocol development
44
---
55

6-
We welcome contributions from the community! Please review our [contributing guidelines](https://github.com/modelcontextprotocol/.github/blob/main/CONTRIBUTING.md) for details on how to submit changes.
6+
We welcome contributions from the community! Please review our [contributing guidelines](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/CONTRIBUTING.md) for details on how to submit changes.
77

8-
All contributors must adhere to our [Code of Conduct](https://github.com/modelcontextprotocol/.github/blob/main/CODE_OF_CONDUCT.md).
8+
All contributors must adhere to our [Code of Conduct](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/CODE_OF_CONDUCT.md).
99

10-
For questions and discussions, please use [GitHub Discussions](https://github.com/orgs/modelcontextprotocol/discussions).
10+
For questions and discussions, please use [GitHub Discussions](https://github.com/modelcontextprotocol/modelcontextprotocol/discussions).

‎docs/docs.json

Lines changed: 182 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,25 @@
11
{
22
"$schema": "https://mintlify.com/docs.json",
3-
"theme": "willow",
3+
"theme": "mint",
44
"name": "Model Context Protocol",
55
"colors": {
66
"primary": "#09090b",
77
"light": "#FAFAFA",
88
"dark": "#09090b"
99
},
1010
"favicon": "/favicon.svg",
11+
"navbar": {
12+
"links": [
13+
{
14+
"label": "GitHub",
15+
"href": "https://github.com/modelcontextprotocol"
16+
}
17+
]
18+
},
1119
"navigation": {
12-
"tabs": [
20+
"versions": [
1321
{
14-
"tab": "User Guide",
22+
"version": "2025-03-26",
1523
"groups": [
1624
{
1725
"group": "Get Started",
@@ -25,19 +33,36 @@
2533
"quickstart/user"
2634
]
2735
},
28-
"examples",
29-
"clients",
36+
{
37+
"group": "SDKs",
38+
"pages": [
39+
"links/sdks/csharp",
40+
"links/sdks/java",
41+
"links/sdks/kotlin",
42+
"links/sdks/python",
43+
"links/sdks/ruby",
44+
"links/sdks/swift",
45+
"links/sdks/typescript"
46+
]
47+
},
48+
{
49+
"group": "Examples",
50+
"pages": [
51+
"examples",
52+
"clients"
53+
]
54+
},
55+
{
56+
"group": "Tutorials",
57+
"pages": [
58+
"tutorials/building-mcp-with-llms",
59+
"docs/tools/debugging",
60+
"docs/tools/inspector"
61+
]
62+
},
3063
"faqs"
3164
]
3265
},
33-
{
34-
"group": "Tutorials",
35-
"pages": [
36-
"tutorials/building-mcp-with-llms",
37-
"docs/tools/debugging",
38-
"docs/tools/inspector"
39-
]
40-
},
4166
{
4267
"group": "Concepts",
4368
"pages": [
@@ -51,20 +76,7 @@
5176
]
5277
},
5378
{
54-
"group": "Development",
55-
"pages": [
56-
"development/roadmap",
57-
"development/contributing"
58-
]
59-
}
60-
]
61-
},
62-
{
63-
"tab": "Specification",
64-
"icon": "book",
65-
"groups": [
66-
{
67-
"group": "2025-03-26 (Latest)",
79+
"group": "Protocol",
6880
"pages": [
6981
"specification/2025-03-26/index",
7082
"specification/2025-03-26/changelog",
@@ -113,7 +125,74 @@
113125
]
114126
},
115127
{
116-
"group": "2024-11-05",
128+
"group": "Development",
129+
"pages": [
130+
"specification/versioning",
131+
"development/roadmap",
132+
"development/contributing"
133+
]
134+
}
135+
]
136+
},
137+
{
138+
"version": "2024-11-05",
139+
"groups": [
140+
{
141+
"group": "Get Started",
142+
"pages": [
143+
"introduction",
144+
{
145+
"group": "Quickstart",
146+
"pages": [
147+
"quickstart/server",
148+
"quickstart/client",
149+
"quickstart/user"
150+
]
151+
},
152+
{
153+
"group": "SDKs",
154+
"pages": [
155+
"links/sdks/csharp",
156+
"links/sdks/java",
157+
"links/sdks/kotlin",
158+
"links/sdks/python",
159+
"links/sdks/ruby",
160+
"links/sdks/swift",
161+
"links/sdks/typescript"
162+
]
163+
},
164+
{
165+
"group": "Examples",
166+
"pages": [
167+
"examples",
168+
"clients"
169+
]
170+
},
171+
{
172+
"group": "Tutorials",
173+
"pages": [
174+
"tutorials/building-mcp-with-llms",
175+
"docs/tools/debugging",
176+
"docs/tools/inspector"
177+
]
178+
},
179+
"faqs"
180+
]
181+
},
182+
{
183+
"group": "Concepts",
184+
"pages": [
185+
"docs/concepts/architecture",
186+
"docs/concepts/resources",
187+
"docs/concepts/prompts",
188+
"docs/concepts/tools",
189+
"docs/concepts/sampling",
190+
"docs/concepts/roots",
191+
"docs/concepts/transports"
192+
]
193+
},
194+
{
195+
"group": "Protocol",
117196
"pages": [
118197
"specification/2024-11-05/index",
119198
"specification/2024-11-05/architecture/index",
@@ -161,7 +240,74 @@
161240
]
162241
},
163242
{
164-
"group": "draft",
243+
"group": "Development",
244+
"pages": [
245+
"specification/versioning",
246+
"development/roadmap",
247+
"development/contributing"
248+
]
249+
}
250+
]
251+
},
252+
{
253+
"version": "Draft",
254+
"groups": [
255+
{
256+
"group": "Get Started",
257+
"pages": [
258+
"introduction",
259+
{
260+
"group": "Quickstart",
261+
"pages": [
262+
"quickstart/server",
263+
"quickstart/client",
264+
"quickstart/user"
265+
]
266+
},
267+
{
268+
"group": "SDKs",
269+
"pages": [
270+
"links/sdks/csharp",
271+
"links/sdks/java",
272+
"links/sdks/kotlin",
273+
"links/sdks/python",
274+
"links/sdks/ruby",
275+
"links/sdks/swift",
276+
"links/sdks/typescript"
277+
]
278+
},
279+
{
280+
"group": "Examples",
281+
"pages": [
282+
"examples",
283+
"clients"
284+
]
285+
},
286+
{
287+
"group": "Tutorials",
288+
"pages": [
289+
"tutorials/building-mcp-with-llms",
290+
"docs/tools/debugging",
291+
"docs/tools/inspector"
292+
]
293+
},
294+
"faqs"
295+
]
296+
},
297+
{
298+
"group": "Concepts",
299+
"pages": [
300+
"docs/concepts/architecture",
301+
"docs/concepts/resources",
302+
"docs/concepts/prompts",
303+
"docs/concepts/tools",
304+
"docs/concepts/sampling",
305+
"docs/concepts/roots",
306+
"docs/concepts/transports"
307+
]
308+
},
309+
{
310+
"group": "Protocol",
165311
"pages": [
166312
"specification/draft/index",
167313
"specification/draft/changelog",
@@ -212,64 +358,21 @@
212358
]
213359
},
214360
{
215-
"group": "Resources",
216-
"pages": ["specification/versioning", "specification/contributing"]
361+
"group": "Development",
362+
"pages": [
363+
"specification/versioning",
364+
"development/roadmap",
365+
"development/contributing"
366+
]
217367
}
218368
]
219369
}
220-
],
221-
"global": {
222-
"anchors": [
223-
{
224-
"anchor": "C# SDK",
225-
"href": "https://github.com/modelcontextprotocol/csharp-sdk",
226-
"icon": "square-c"
227-
},
228-
{
229-
"anchor": "Java SDK",
230-
"href": "https://github.com/modelcontextprotocol/java-sdk",
231-
"icon": "java"
232-
},
233-
{
234-
"anchor": "Kotlin SDK",
235-
"href": "https://github.com/modelcontextprotocol/kotlin-sdk",
236-
"icon": "square-k"
237-
},
238-
{
239-
"anchor": "Python SDK",
240-
"href": "https://github.com/modelcontextprotocol/python-sdk",
241-
"icon": "python"
242-
},
243-
{
244-
"anchor": "Ruby SDK",
245-
"href": "https://github.com/modelcontextprotocol/ruby-sdk",
246-
"icon": "gem"
247-
},
248-
{
249-
"anchor": "Swift SDK",
250-
"href": "https://github.com/modelcontextprotocol/swift-sdk",
251-
"icon": "swift"
252-
},
253-
{
254-
"anchor": "TypeScript SDK",
255-
"href": "https://github.com/modelcontextprotocol/typescript-sdk",
256-
"icon": "square-js"
257-
}
258-
]
259-
}
370+
]
260371
},
261372
"logo": {
262373
"light": "/logo/light.svg",
263374
"dark": "/logo/dark.svg"
264375
},
265-
"navbar": {
266-
"links": [],
267-
"primary": {
268-
"type": "button",
269-
"label": "GitHub",
270-
"href": "https://github.com/modelcontextprotocol"
271-
}
272-
},
273376
"seo": {
274377
"metatags": {
275378
"og:image": "https://raw.githubusercontent.com/modelcontextprotocol/docs/2eb6171ddbfeefde349dc3b8d5e2b87414c26250/images/og-image.png"

‎docs/links/sdks/csharp.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: C# SDK
3+
url: https://github.com/modelcontextprotocol/csharp-sdk
4+
icon: square-c
5+
---
6+
7+
<Card
8+
title="C# SDK"
9+
href="https://github.com/modelcontextprotocol/csharp-sdk"
10+
/>

‎docs/links/sdks/java.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Java SDK
3+
url: https://github.com/modelcontextprotocol/java-sdk
4+
icon: java
5+
---
6+
7+
<Card
8+
title="Java SDK"
9+
href="https://github.com/modelcontextprotocol/java-sdk"
10+
/>

‎docs/links/sdks/kotlin.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Kotlin SDK
3+
url: https://github.com/modelcontextprotocol/kotlin-sdk
4+
icon: square-k
5+
---
6+
7+
<Card
8+
title="Kotlin SDK"
9+
href="https://github.com/modelcontextprotocol/kotlin-sdk"
10+
/>

‎docs/links/sdks/python.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Python SDK
3+
url: https://github.com/modelcontextprotocol/python-sdk
4+
icon: python
5+
---
6+
7+
<Card
8+
title="Python SDK"
9+
href="https://github.com/modelcontextprotocol/python-sdk"
10+
/>

‎docs/links/sdks/ruby.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Ruby SDK
3+
url: https://github.com/modelcontextprotocol/ruby-sdk
4+
icon: gem
5+
---
6+
7+
<Card
8+
title="Ruby SDK"
9+
href="https://github.com/modelcontextprotocol/ruby-sdk"
10+
/>

‎docs/links/sdks/swift.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Swift SDK
3+
url: https://github.com/modelcontextprotocol/swift-sdk
4+
icon: swift
5+
---
6+
7+
<Card
8+
title="Swift SDK"
9+
href="https://github.com/modelcontextprotocol/swift-sdk"
10+
/>

0 commit comments

Comments
 (0)