SYSLIB1219 (and placeholder SYSLIB1218) missing from the options-validation source-generator diagnostics reference
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 72/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- csharp
调研方向
打开 docs/fundamentals/syslib-diagnostics/syslib1201-1219.md，检查现有的诊断表和 front matter。根据 Microsoft.Extensions.Options/gen/DiagDescriptors.cs 验证 SYSLIB1219，然后与 runtime 团队确认对保留的 SYSLIB1218 的预期处理方式。完成的标准是参考文档和关键字准确反映受支持的诊断。
由索引模型根据 Issue 内容生成。
描述
Description
The options-validation source-generator diagnostics reference page's front matter (f1_keywords) already lists syslib1218 and syslib1219, but the description table only documents SYSLIB1201-SYSLIB1217. Two diagnostic IDs are undocumented:
SYSLIB1219(AlreadyImplementsValidateAsyncMethod) - a new diagnostic introduced with async options-validation source generation (ValidateAsyncemission forIAsyncValidateOptions<TOptions>), defined inDiagDescriptors.cs. It's the async counterpart to the existingSYSLIB1205(AlreadyImplementsValidateMethod): the generator reports it when an attributed type already provides a handwrittenValidateAsyncmethod matching the generated signature.SYSLIB1218- reserved as a keyword but not currently defined by any diagnostic descriptor in the Options source generator. Needs confirmation of intent (reserved for future use vs. removable from front matter).
Repro / evidence
- Front matter lists both IDs: syslib1201-1219.md front matter
- Table stops at
SYSLIB1217: no rows for 1218/1219. SYSLIB1219diagnostic descriptor:Microsoft.Extensions.Options/gen/DiagDescriptors.cs,id: "SYSLIB1219", messageSR.AlreadyImplementsValidateAsyncMethodMessage.
Suggested content
Add a table row:
| Diagnostic ID | Description |
|---|---|
SYSLIB1219 |
A type already includes an implementation of the ValidateAsync method. |
And either:
- Add a
SYSLIB1218row once its purpose is confirmed with the runtime team, or - Remove
syslib1218fromf1_keywordsif it's unused/reserved and not meant to surface publicly yet.
Type of gap
Not a breaking change - SYSLIB1219 is a new diagnostic tied to a new generator capability (async Validate generation), not a change to previously working behavior. This is a plain content gap in an existing reference page.
Related
- Async options-validation source generation: dotnet/runtime#130263
- Related (already-addressed) breaking-change doc for the async validation contract unification: dotnet/docs#55794 / dotnet/docs#55901 (unrelated to this diagnostic gap)
This issue was drafted with assistance from GitHub Copilot.
- 主要语言
- 没有语言数据
- 星标
- 4.8k
- 派生
- 6.1k
- 平均合并
- 23 小时 7 分钟
- 30 天内合并 PR
- 196
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
dotnet/docs 的其他 Issue
-
Document unit-test / theory-data impact of .NET 11 double→decimal conversion可能已有人在做 @SkyDevLab 于 1 天前认领。 未关闭:watch: Not Triaged dotnet-fundamentals/svc
难度 1/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
-
:watch: Not Triaged dotnet-fundamentals/svc
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
dotnet-fundamentals/svc install/subsvc
难度 2/5 1-3 小时 新手友好度 72/100
dotnet/docs#56344 · 1 个 reaction ·
维护者通常 1 天内回复
-
Upgrade from `net9.0` to LTS (or STS) image tag可能已有人在做 @ShyneChikwapulo 于 9 天前认领。 未关闭dotnet-target-version
难度 1/5 1 小时以内 新手友好度 85/100
dotnet/docs#56293 · 3 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
-
Documentation for dotnet sln add doesn't mention the --include-references flag可能已有人在做 @BartoszKlonowski 于 9 天前认领。 未关闭dotnet-fundamentals/svc
难度 1/5 1 小时以内 新手友好度 92/100
dotnet/docs#56289 · 2 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
相似的 Issue
-
docs good first issue
难度 2/5 1-3 小时 新手友好度 85/100
Usenova-Labs/usenova-backend#36 ·
维护者通常 1 天内回复
-
git: README should state plainly that without --repository every reachable repository is in scope未关闭documentation server-git v2
难度 1/5 1-3 小时 新手友好度 84/100
modelcontextprotocol/servers#5225 ·
维护者通常 1 天内回复
-
data documentation
难度 1/5 1 小时以内 新手友好度 95/100
userFRM/egui-charts#623 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
microsoft/vscode-docs#10534 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 80/100
Droid-Deck/DroidDeck#1355 ·
维护者通常 1 天内回复