Skip to content

Add documentation comments to config.yml#89

Open
Morriar wants to merge 1 commit into
masterfrom
document-config-nodes
Open

Add documentation comments to config.yml#89
Morriar wants to merge 1 commit into
masterfrom
document-config-nodes

Conversation

@Morriar
Copy link
Copy Markdown

@Morriar Morriar commented May 11, 2026

Summary

  • Add comment: fields to all 77 AST node types, their fields, and all 6 enums in config.yml
  • Follow the same documentation pattern used by Prism: prose description + RBS code example with ^^^^ location markers
  • The comment: keys are safely ignored by both the Ruby template engine (templates/template.rb) and the Rust serde deserializer (build.rs), so no generated code changes

Closes https://github.com/Shopify/team-ruby-dx/issues/1388

@Morriar Morriar force-pushed the document-config-nodes branch 2 times, most recently from 0fcb209 to 71a5840 Compare May 11, 2026 21:09
Add `comment:` fields to all 77 node definitions in config.yml,
following Prism's documentation pattern with prose descriptions,
RBS code examples, and caret location markers.
@Morriar Morriar force-pushed the document-config-nodes branch from 71a5840 to 736e449 Compare May 11, 2026 21:11
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.

1 participant