Skip to content

Commit cbfe447

Browse files
jonathanhefnerjonathanhefner
committed
Nest SDK links in "Get Started" group
Prior to this commit, the SDK links took up a lot of valuable real estate at the top of the navigation sidebar. Rather than being a deliberate choice, their placement seemed to be an artifact of Mintlify's limitations. In Mintlify's configuration schema, external links cannot be put into sidebar groups. Instead they must be put in the `anchors` section, which is always rendered at the top of the sidebar. Conversely, each entry in a group must refer to a page. However, if a page's front matter contains the `url` property, Mintlify will render links to that page as external links to the specified URL. So this commit creates a stub page with a `url` property for each SDK, and puts corresponding entries in the "Get Started" group, which are then rendered as external links.
1 parent a591bc5 commit cbfe447

File tree

8 files changed

+106
-39
lines changed

8 files changed

+106
-39
lines changed

‎docs/docs.json

Lines changed: 36 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -9,45 +9,6 @@
99
},
1010
"favicon": "/favicon.svg",
1111
"navigation": {
12-
"global": {
13-
"anchors": [
14-
{
15-
"anchor": "C# SDK",
16-
"href": "https://github.com/modelcontextprotocol/csharp-sdk",
17-
"icon": "square-c"
18-
},
19-
{
20-
"anchor": "Java SDK",
21-
"href": "https://github.com/modelcontextprotocol/java-sdk",
22-
"icon": "java"
23-
},
24-
{
25-
"anchor": "Kotlin SDK",
26-
"href": "https://github.com/modelcontextprotocol/kotlin-sdk",
27-
"icon": "square-k"
28-
},
29-
{
30-
"anchor": "Python SDK",
31-
"href": "https://github.com/modelcontextprotocol/python-sdk",
32-
"icon": "python"
33-
},
34-
{
35-
"anchor": "Ruby SDK",
36-
"href": "https://github.com/modelcontextprotocol/ruby-sdk",
37-
"icon": "gem"
38-
},
39-
{
40-
"anchor": "Swift SDK",
41-
"href": "https://github.com/modelcontextprotocol/swift-sdk",
42-
"icon": "swift"
43-
},
44-
{
45-
"anchor": "TypeScript SDK",
46-
"href": "https://github.com/modelcontextprotocol/typescript-sdk",
47-
"icon": "square-js"
48-
}
49-
]
50-
},
5112
"versions": [
5213
{
5314
"version": "2025-03-26",
@@ -64,6 +25,18 @@
6425
"quickstart/user"
6526
]
6627
},
28+
{
29+
"group": "SDKs",
30+
"pages": [
31+
"links/sdks/csharp",
32+
"links/sdks/java",
33+
"links/sdks/kotlin",
34+
"links/sdks/python",
35+
"links/sdks/ruby",
36+
"links/sdks/swift",
37+
"links/sdks/typescript"
38+
]
39+
},
6740
{
6841
"group": "Examples",
6942
"pages": [
@@ -169,6 +142,18 @@
169142
"quickstart/user"
170143
]
171144
},
145+
{
146+
"group": "SDKs",
147+
"pages": [
148+
"links/sdks/csharp",
149+
"links/sdks/java",
150+
"links/sdks/kotlin",
151+
"links/sdks/python",
152+
"links/sdks/ruby",
153+
"links/sdks/swift",
154+
"links/sdks/typescript"
155+
]
156+
},
172157
{
173158
"group": "Examples",
174159
"pages": [
@@ -273,6 +258,18 @@
273258
"quickstart/user"
274259
]
275260
},
261+
{
262+
"group": "SDKs",
263+
"pages": [
264+
"links/sdks/csharp",
265+
"links/sdks/java",
266+
"links/sdks/kotlin",
267+
"links/sdks/python",
268+
"links/sdks/ruby",
269+
"links/sdks/swift",
270+
"links/sdks/typescript"
271+
]
272+
},
276273
{
277274
"group": "Examples",
278275
"pages": [

‎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+
/>

‎docs/links/sdks/typescript.mdx

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

0 commit comments

Comments
 (0)