Six generated doc twins under lexicons/*/docs/src/content/docs/ do not match what their generator produces today. Running each lexicon's npm run docs on a clean tree at 4853da2, with no source edits, rewrites all six.
lexicons/aws/docs/src/content/docs/index.mdxlexicons/aws/docs/src/content/docs/intrinsics.mdxlexicons/cedar/docs/src/content/docs/index.mdxlexicons/github/docs/src/content/docs/index.mdxlexicons/gitlab/docs/src/content/docs/index.mdxlexicons/k8s/docs/src/content/docs/index.mdx
The changes are lexicon version strings (0.49.0, 0.51.0 and 0.56.0 all moving to 0.57.0) and two intrinsic-function counts.
Why this is not just a stale twin to regenerate in place
The generator reads each lexicon's local dist/manifest.json, and in a working checkout those manifests are themselves stale relative to src/, so regenerating locally writes numbers that are wrong in a different way. Two measurements:
CI runs prepack fresh, so the correct content of these six pages is not knowable from a developer checkout with pre-seeded dist/. Regenerating from a stale manifest would replace one wrong number with another and make the twins look current.
What to do
Regenerate the six from a fresh prepack: build each lexicon so dist/manifest.json is rebuilt from src/, then run that lexicon's npm run docs, then check the intrinsic counts against src/ by hand before committing (aws should come back to thirteen, github's should be whatever src/ actually registers). This is the shape ffb1bd6 used for #1980: stale twins regenerated as their own PR rather than folded into an unrelated one.
Found while doing #2194 (PR #2198), which regenerated these six as a side effect and has since restored them to main so its own diff stays to the pages it edits.
Six generated doc twins under
lexicons/*/docs/src/content/docs/do not match what their generator produces today. Running each lexicon'snpm run docson a clean tree at 4853da2, with no source edits, rewrites all six.lexicons/aws/docs/src/content/docs/index.mdxlexicons/aws/docs/src/content/docs/intrinsics.mdxlexicons/cedar/docs/src/content/docs/index.mdxlexicons/github/docs/src/content/docs/index.mdxlexicons/gitlab/docs/src/content/docs/index.mdxlexicons/k8s/docs/src/content/docs/index.mdxThe changes are lexicon version strings (0.49.0, 0.51.0 and 0.56.0 all moving to 0.57.0) and two intrinsic-function counts.
Why this is not just a stale twin to regenerate in place
The generator reads each lexicon's local
dist/manifest.json, and in a working checkout those manifests are themselves stale relative tosrc/, so regenerating locally writes numbers that are wrong in a different way. Two measurements:lexicons/aws/src/intrinsics.tsdefinesFn::Equals,Fn::And,Fn::OrandFn::Not(aws: conditions can be referenced (Condition key, Fn::If) but never declared; a build that names one succeeds and CloudFormation rejects the template #2068), which is thirteen intrinsics.lexicons/aws/dist/manifest.jsonis version 0.56.0 and lists nine. The committed twin says thirteen; a local regeneration writes nine, and drops the four condition rows from theintrinsics.mdxtable.lexicons/github/dist/manifest.jsonis dated Aug 25 at version 0.46.0 and lists one intrinsic. The committed twin says nineteen; a local regeneration writes one.CI runs prepack fresh, so the correct content of these six pages is not knowable from a developer checkout with pre-seeded
dist/. Regenerating from a stale manifest would replace one wrong number with another and make the twins look current.What to do
Regenerate the six from a fresh prepack: build each lexicon so
dist/manifest.jsonis rebuilt fromsrc/, then run that lexicon'snpm run docs, then check the intrinsic counts againstsrc/by hand before committing (aws should come back to thirteen, github's should be whateversrc/actually registers). This is the shape ffb1bd6 used for #1980: stale twins regenerated as their own PR rather than folded into an unrelated one.Found while doing #2194 (PR #2198), which regenerated these six as a side effect and has since restored them to main so its own diff stays to the pages it edits.