Merge pull request modelcontextprotocol#59 from modelcontextprotocol/justin/clarify-its-a-spec

Clarify these are spec pages, clean up navigation

Author: jspahrsummers

CONTRIBUTING.md

@@ -9,7 +9,7 @@ The following software is required to work on the spec:
 - Node.js 20 or above
 - TypeScript
 - TypeScript JSON Schema (for generating JSON schema)
-- Hugo (optional, for docs)
+- [Hugo](https://gohugo.io/) (optional, for docs)
 - Go (optional, for docs)
 - nvm (optional, for managing Node versions)
 

docs/_index.md

@@ -1,10 +1,11 @@
 ---
-title: Specification
+title: Model Context Protocol Specification
 cascade:
   type: docs
+breadcrumbs: false
 weight: 1
 ---
-The following is the formal specification of the Model Context Protocol, and aims
+The following is the formal specification of the [Model Context Protocol](https://modelcontextprotocol.io), and aims
 to be a resource for implementors.
 
-For a user guides and SDK configuration, plesae visit https://modelcontextprotocol.io.
+For a user guides and SDK configuration, please visit https://modelcontextprotocol.io.

docs/documentation/_index.md renamed to docs/resources/_index.md

@@ -1,6 +1,9 @@
 ---
-title: "User Documentation"
+title: "Additional Resources"
 weight: 20
+breadcrumbs: false
+sidebar:
+  exclude: true
 ---
 
 The Model Context Protocol (MCP) provides multiple resources for documentation and implementation:

docs/specification/_index.md

@@ -2,6 +2,7 @@
 title: Specification
 cascade:
   type: docs
+breadcrumbs: false
 weight: 10
 ---
 

docs/specification/contributing/_index.md

@@ -1,6 +1,9 @@
 ---
-title: "Contributing to MCP"
+title: "Contributions"
 weight: 10
+cascade:
+  type: docs
+breadcrumbs: false
 ---
 
 The Model Context Protocol specification welcomes contributions from the community.

package-lock.json

@@ -1,5 +1,6 @@
 {
   "name": "@modelcontextprotocol/specification",
+  "private": true,
   "version": "0.1.0",
   "description": "Model Context Protocol specification and protocol schema",
   "license": "MIT",

package.json

@@ -1,6 +1,7 @@
 baseURL: "https://spec.modelcontextprotocol.io"
+title: Model Context Protocol Specification
 
-
+enableEmoji: true
 enableRobotsTXT: true
 enableGitInfo: true
 
@@ -62,8 +63,8 @@ menu:
     - name: Specification
       pageRef: /
       weight: 1
-    - name: User Guide
-      pageRef: /documentation
+    - name: Resources
+      pageRef: /resources
       weight: 2
     - name: Search
       weight: 3
@@ -74,3 +75,26 @@ menu:
       url: "https://github.com/modelcontextprotocol/specification"
       params:
         icon: github
+
+  sidebar:
+    - identifier: schema
+      name: "Schema ↗"
+      url: "https://github.com/modelcontextprotocol/specification/tree/main/schema"
+      weight: 1
+    - identifier: more
+      name: More
+      params:
+        type: separator
+      weight: 2
+    - identifier: userDocs
+      name: "User Guide ↗"
+      url: "https://modelcontextprotocol.io"
+      weight: 3
+    - identifier: pythonSdk
+      name: "Python SDK ↗"
+      url: "https://github.com/modelcontextprotocol/python-sdk"
+      weight: 4
+    - identifier: typescriptSdk
+      name: "TypeScript SDK ↗"
+      url: "https://github.com/modelcontextprotocol/typescript-sdk"
+      weight: 5