Skip to content

Comments

Simplify and update package README.md files for stable release#1388

Open
Copilot wants to merge 6 commits intomainfrom
copilot/update-readmes-for-modelcontextprotocol
Open

Simplify and update package README.md files for stable release#1388
Copilot wants to merge 6 commits intomainfrom
copilot/update-readmes-for-modelcontextprotocol

Conversation

Copy link
Contributor

Copilot AI commented Feb 25, 2026

Simplifies the package READMEs for ModelContextProtocol.Core, ModelContextProtocol, and ModelContextProtocol.AspNetCore to match the pattern established in #1387 for the root README. Also updates the top-level README.md with consistent documentation links.

  • Updated src/ModelContextProtocol.Core/README.md: removed preview note, updated NuGet badge to stable, removed --prerelease from install command, removed inline code samples and linked to Getting Started docs instead, changed "our" to "the" for API documentation reference
  • Updated src/ModelContextProtocol.AspNetCore/README.md: removed preview note, fixed NuGet badge to reference correct package, removed --prerelease from install command, removed inline code samples and linked to Getting Started docs instead, changed "our" to "the" for API documentation reference
  • Created src/ModelContextProtocol/README.md with simplified content linking to Getting Started docs, including a Packages section with absolute URLs to the docs site
  • Updated src/ModelContextProtocol/ModelContextProtocol.csproj to reference the new local README.md instead of the root README.md
  • Renamed "Official Documentation" to "Official MCP Documentation" and added "MCP C# SDK Documentation" link in all three package READMEs and the top-level README

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

…l README

- ModelContextProtocol.Core/README.md: Remove preview note, update NuGet badge to stable, remove --prerelease from install
- ModelContextProtocol.AspNetCore/README.md: Remove preview note, fix NuGet badge to correct package and stable, remove --prerelease from install
- ModelContextProtocol/README.md: New README with hosting example from getting started docs
- ModelContextProtocol.csproj: Reference new local README.md instead of root README.md

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
@jeffhandley
Copy link
Collaborator

@copilot Review the changes made in #1387 and apply similar editing here, simplifying the package READMEs in the same manner. Instead of including Getting Started content with samples in the package README files, link to the Getting Started documentation page introduced and referenced in that PR. Also look change "our API documentation" to "the API documentation" as was done in the other PR.

Remove inline code samples from all three package READMEs and link to
the Getting Started documentation page instead. Change "our" to "the"
for API documentation references. Tighten package descriptions.

Co-authored-by: jeffhandley <1031940+jeffhandley@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 25, 2026

@copilot Review the changes made in #1387 and apply similar editing here, simplifying the package READMEs in the same manner. Instead of including Getting Started content with samples in the package R...

Simplified all three package READMEs to match the pattern from #1387 in 9382bb5. Removed all inline code samples and replaced Getting Started sections with links to the documentation page. Changed "our API documentation" to "the API documentation" across all files. Also tightened each package's description to be more specific about what it provides.

Copilot AI changed the title [WIP] Update README.md files for ModelContextProtocol libraries Simplify and update package README.md files for stable release Feb 25, 2026
Copilot AI requested a review from jeffhandley February 25, 2026 05:25
public static string Echo(string message) => $"hello {message}";
}
```
- [Official Documentation](https://modelcontextprotocol.io/)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Each place where we list these links, change "Official Documentation" to "Official MCP Documentation", and add a link after it for the "MCP C# SDK Documentation" that links to https://modelcontextprotocol.github.io/csharp-sdk/.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated all three package READMEs in 1a8bf62: renamed "Official Documentation" to "Official MCP Documentation" and added "MCP C# SDK Documentation" link to https://modelcontextprotocol.github.io/csharp-sdk/ after it.

…ation" and add "MCP C# SDK Documentation" link

Co-authored-by: jeffhandley <1031940+jeffhandley@users.noreply.github.com>
…umentation URLs

Co-authored-by: jeffhandley <1031940+jeffhandley@users.noreply.github.com>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@stephentoub et al - this forks the README for the repo and the README for the MCP package whereas we previously reused the same doc for both purposes. With the reduced content, I'm good with the split as this allows the links to be set up appropriately for each of the two contexts.

Co-authored-by: jeffhandley <1031940+jeffhandley@users.noreply.github.com>
@jeffhandley jeffhandley marked this pull request as ready for review February 25, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants