feat: document group field dot notation in field add help#152
feat: document group field dot notation in field add help#152angeloashmore merged 2 commits intomainfrom
Conversation
Add sections support to command routers and use it to document dot notation for adding fields inside groups (e.g. my_group.description). Resolves #139 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
angeloashmore
left a comment
There was a problem hiding this comment.
Is it necessary to add that bit about group fields into every field type supported in group fields? Conversely, do we need to explicitly state in each field type if it is not supported in groups (for example, groups cannot have groups).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 84c514b. Configure here.
angeloashmore
left a comment
There was a problem hiding this comment.
The dot notation section is only on the field add router help, not duplicated into each field type. This seems like the right place since it applies to all field types that support groups. I don't think we need to explicitly state in each field type whether it supports groups -- that's better left to the docs or error messages when someone tries to nest unsupported types.

Resolves: #139
Description
Documents the dot notation syntax for adding fields inside groups (e.g.
prismic field add text my_group.description --to-type blog_post). Addssectionssupport to command routers so thefield addrouter can show a GROUP FIELDS section in its--helpoutput.Checklist
Preview
How to QA 1
Run
prismic field add --helpand verify the GROUP FIELDS section appears explaining dot notation.Note
Low Risk
Low risk: changes only CLI help text rendering and adds an optional
sectionsblock to router help output, with no impact on command execution paths beyond printing help.Overview
Adds optional
sectionssupport tocreateCommandRouterhelp generation so routers can display additional formatted documentation blocks.Updates
prismic field add --helpto include a GROUP FIELDS section describing dot-notation (my_group.description) for adding fields inside existing groups.Reviewed by Cursor Bugbot for commit 84c514b. Bugbot is set up for automated code reviews on this repo. Configure here.
Footnotes
Please use these labels when submitting a review:
⚠️ #issue: Strongly suggest a change.
❓ #ask: Ask a question.
💡 #idea: Suggest an idea.
🎉 #nice: Share a compliment. ↩