Skip to content

Commit d3ed10a

Browse files
jeffhandleyCopilot
andcommitted
Clean up markdown-link-check workflow and fix stale URLs
- Remove stale ignore rules for anthropic.com and hackerone.com - Add ignore rule for DocFX xref: links that mlc cannot check - Add redirect suppression for learn.microsoft.com locale redirects - Remove stale redirect rules for modelcontextprotocol.io and GitHub login - Update RFC URLs from tools.ietf.org to datatracker.ietf.org - Update GitHub Pages URLs to csharp.sdk.modelcontextprotocol.io custom domain - Reformat args to multi-line with descriptive comments Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 1578e94 commit d3ed10a

File tree

7 files changed

+17
-9
lines changed

7 files changed

+17
-9
lines changed

.github/workflows/markdown-link-check.yml

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,5 +21,13 @@ jobs:
2121
- name: Markup Link Checker (mlc)
2222
uses: becheran/mlc@7ec24825cefe0c9c8c6bac48430e1f69e3ec356e # v1.2.0
2323
with:
24-
# Ignore external links that result in 403 errors during CI. Do not warn for redirects where we want to keep the vanity URL in the markdown or for GitHub links that redirect to the login, and DocFX snippet links.
25-
args: --ignore-links "https://www.anthropic.com/*,https://hackerone.com/anthropic-vdp/*" --do-not-warn-for-redirect-to "https://modelcontextprotocol.io/*,https://github.com/login?*" --ignore-links "*samples/*?name=snippet_*" ./docs
24+
# Ignore DocFX cross-reference links (xref:) that mlc cannot check.
25+
# Ignore DocFX snippet inclusion links.
26+
# Do not warn for learn.microsoft.com locale redirects.
27+
# Do not warn for modelcontextprotocol.io homepage/spec redirects.
28+
args: >-
29+
--ignore-links "xref:*"
30+
--ignore-links "*samples/*?name=snippet_*"
31+
--do-not-warn-for-redirect-to "https://learn.microsoft.com/en-us/*"
32+
--do-not-warn-for-redirect-to "https://modelcontextprotocol.io/*"
33+
./docs

docs/concepts/logging/logging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ This document describes how to implement logging in MCP servers and how clients
1515

1616
### Logging Levels
1717

18-
MCP uses the logging levels defined in [RFC 5424](https://tools.ietf.org/html/rfc5424).
18+
MCP uses the logging levels defined in [RFC 5424](https://datatracker.ietf.org/doc/html/rfc5424).
1919

2020
The MCP C# SDK uses the standard .NET [ILogger] and [ILoggerProvider] abstractions, which support a slightly
2121
different set of logging levels. The following table shows the levels and how they map to standard .NET logging levels.

docs/concepts/resources/resources.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ public class MyResources
4343

4444
Template resources use [URI templates (RFC 6570)] with parameters. They are returned separately in the resource templates list and can match a range of URIs:
4545

46-
[URI templates (RFC 6570)]: https://tools.ietf.org/html/rfc6570
46+
[URI templates (RFC 6570)]: https://datatracker.ietf.org/doc/html/rfc6570
4747

4848
```csharp
4949
[McpServerResourceType]

docs/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ This SDK is the official C# SDK for the [Model Context Protocol](https://modelco
88

99
For more details on available functionality, see:
1010

11-
- [Conceptual documentation](https://modelcontextprotocol.github.io/csharp-sdk/concepts/index.html)
12-
- [API documentation](https://modelcontextprotocol.github.io/csharp-sdk/api/ModelContextProtocol.html).
11+
- [Conceptual documentation](https://csharp.sdk.modelcontextprotocol.io/concepts/index.html)
12+
- [API documentation](https://csharp.sdk.modelcontextprotocol.io/api/ModelContextProtocol.html).
1313

1414
## About MCP
1515

docs/list-of-diagnostics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Analyzer diagnostic IDs are in the format `MCP###`.
99
| Diagnostic ID | Description |
1010
| :------------ | :---------- |
1111
| `MCP001` | Invalid XML documentation for MCP method |
12-
| `MCP002` | MCP method must be partial to generate [Description] attributes |
12+
| `MCP002` | MCP method must be partial to generate `[Description]` attributes |
1313

1414
## Experimental APIs
1515

docs/roadmap.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ uid: roadmap
66
---
77
## Spec Implementation Tracking
88

9-
The C# SDK tracks implementation of MCP spec components using the [modelcontextprotocol project boards](https://github.com/orgs/modelcontextprotocol/projects), with a dedicated project board for each spec revision. For example, see the [2025-11-25 spec revision board](https://github.com/orgs/modelcontextprotocol/projects/26).
9+
The C# SDK tracks implementation of MCP spec components using the [modelcontextprotocol project boards](https://github.com/orgs/modelcontextprotocol/projects?query=is%3Aopen), with a dedicated project board for each spec revision. For example, see the [2025-11-25 spec revision board](https://github.com/orgs/modelcontextprotocol/projects/26).
1010

1111
## Current Focus Areas
1212

docs/versioning.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ All releases are posted to https://github.com/modelcontextprotocol/csharp-sdk/re
4343

4444
### Specification schema changes
4545

46-
If the MCP specification changes the schema for JSON payloads, the C# SDK might use the [`McpSession.NegotiatedProtocolVersion`](https://modelcontextprotocol.github.io/csharp-sdk/api/ModelContextProtocol.McpSession.html#ModelContextProtocol_McpSession_NegotiatedProtocolVersion) to dynamically change the payload schema, potentially using internal data transfer objects (DTOs) to achieve the needed deserialization behavior. These techniques will be applied where feasible to maintain backward-compatibility and forward-compatibility between MCP specification versions.
46+
If the MCP specification changes the schema for JSON payloads, the C# SDK might use the [`McpSession.NegotiatedProtocolVersion`](https://csharp.sdk.modelcontextprotocol.io/api/ModelContextProtocol.McpSession.html#ModelContextProtocol_McpSession_NegotiatedProtocolVersion) to dynamically change the payload schema, potentially using internal data transfer objects (DTOs) to achieve the needed deserialization behavior. These techniques will be applied where feasible to maintain backward-compatibility and forward-compatibility between MCP specification versions.
4747

4848
For illustrations of how this could be achieved, see the following prototypes:
4949

0 commit comments

Comments
 (0)