Skip to content

Commit aa0aff8

Browse files
committed
docs(csharp): api-docs note says gen warns only when --generators names it
The registry Note shown by gen --list and the matching manifest note still said a gen run that lists api-docs warns. After the gen change, an owned project that lists it in codegen/Program.cs is silent; only a --generators selection naming it warns. Text only.
1 parent 6464f85 commit aa0aff8

2 files changed

Lines changed: 2 additions & 2 deletions

File tree

‎fixtures/generator-registry-conformance/registry.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@
9090
"concept": "Per-entity/template SDK API reference (generated-code API; human + agent forms).",
9191
"tier": "native",
9292
"layer": "docs",
93-
"note": "Run by `meta docs` as its api surface (ADR-0025), not by `meta gen`: a `meta gen` config that lists it is warned about and skipped. On csharp it is run by `dotnet meta docs`, and `dotnet meta gen` skips it with a warning.",
93+
"note": "Run by `meta docs` as its api surface (ADR-0025), not by `meta gen`: a `meta gen` config that lists it is warned about and skipped. On csharp it is run by `dotnet meta docs`, and `dotnet meta gen` skips it, warning only when `--generators` names it.",
9494
"ports": ["typescript", "csharp"]
9595
},
9696
"trace-helper": {

‎server/csharp/MetaObjects.Codegen/GeneratorRegistry.cs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ private static IGenerator RenderHelper(GeneratorBuildContext ctx) =>
262262
Tier = GeneratorTier.Native,
263263
Layer = GeneratorLayer.Docs,
264264
Factory = _ => new ApiDocsGenerator(),
265-
Note = "Run by `dotnet meta docs` as its api surface (ADR-0025), not by `dotnet meta gen`: a `gen` run that lists it skips it with a warning.",
265+
Note = "Run by `dotnet meta docs` as its api surface (ADR-0025), not by `dotnet meta gen`: `gen` skips it, and warns when `--generators` names it.",
266266
SourceFileName = "ApiDocsGenerator.cs",
267267
// The page IR, its builder, the renderer and the path math; and the field walk and the
268268
// M:N navigation the builder documents with.

0 commit comments

Comments
 (0)