Merge pull request modelcontextprotocol#54 from modelcontextprotocol/justin/contributing

Add CONTRIBUTING.md

Author: jspahrsummers

CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing to Model Context Protocol
+
+Thank you for your interest in contributing to the Model Context Protocol specification! This document outlines how to contribute to this project.
+
+## Prerequisites
+
+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)
+- Go (optional, for docs)
+- nvm (optional, for managing Node versions)
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork:
+```bash
+git clone https://github.com/YOUR-USERNAME/specification.git
+cd specification
+```
+
+3. Install dependencies:
+```bash
+nvm install  # install correct Node version
+npm install  # install dependencies
+```
+
+## Making Changes
+
+1. Create a new branch:
+```bash
+git checkout -b feature/your-feature-name
+```
+
+2. Make your changes
+3. Validate your changes:
+```bash
+npm run validate:schema    # validate schema
+npm run validate:examples  # validate examples
+npm run generate:json     # generate JSON schema
+```
+
+4. Run docs locally (optional):
+```bash
+npm run serve:docs
+```
+
+## Submitting Changes
+
+1. Push your changes to your fork
+2. Submit a pull request to the main repository
+3. Follow the pull request template
+4. Wait for review
+
+## Code of Conduct
+
+This project follows a Code of Conduct. Please review it in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+## Questions
+
+If you have questions, please create an issue in the repository.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+## Security
+
+Please review our [Security Policy](SECURITY.md) for reporting security issues.

README.md

@@ -4,40 +4,9 @@ This repo contains the specification and protocol schema for the Model Context P
 
 The schema is [defined in TypeScript](schema/schema.ts) first, but [made available as JSON Schema](schema/schema.json) as well, for wider compatibility.
 
-## Prequisites
-
-The following software is required to work on the spec:
-
- * Typescript
- * Node.JS 20 or above
- * Typescript JSON Schema (for generating json schema)
- * Hugo (optionally, for serving the documentation)
- * Go (optionally, for serving the documentation)
- * nvm (optionally, for managing node versions)
-
-## Validating and building the spec
-The following commands install the dependencies, validate the schema and generate the json schema.
-
-```bash
-$ nvm install # install the correct node version
-$ npm install # install dependencies
-$ npm run validate:schema # validate the schema
-$ npm run validate:examples # validate the examples
-$ npm run generate:json # generate the json schema
-```
-
-## Serving the documentation
-The documentation lives in the `docs` folder. To serve the documentation, run the following commands:
-
-```bash
-$ npm run serve:docs # serve the documentation
-```
-
-Note that this requires Hugo and Go to be installed.
-
 ## Contributing
 
-Issues and pull requests are welcome on GitHub at https://github.com/modelcontextprotocol/specification.
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this project.
 
 ## License