Component Layout Decisions

Page-type layout contract for required sections and approved component sets.

Purpose

Use this matrix to decide how content should be structured and which components are acceptable for each page type.

Policy Source

• tools/config/quality/component-layout-profile.json
• tools/config/quality/component-layout-profile.schema.json

Matrix

Page Type	Required Sections	Preferred Components	Avoid
landing	Overview	Card, CardGroup, Tabs, Accordion, AccordionGroup, Note	TODO/TBD placeholders
overview	Overview	Card, CardGroup, Tabs, Accordion, AccordionGroup, CodeGroup, Note	TODO/TBD placeholders
guide	Overview, Steps or H2 sections	Steps, Step, CodeGroup, Note, Info, Tip, Card, CardGroup	Coming Soon, PreviewCallout
quickstart	Prerequisites, Steps, Next Steps	Steps, Step, CodeGroup, Tip, Warning, Check	TODO/TBD, Coming Soon
how_to	Prerequisites, Steps	Steps, Step, CodeGroup, Warning, Check, Tip	Coming Soon, PreviewCallout
reference	Reference	ParamField, ResponseField, CodeGroup, Tabs, Table	TODO/TBD/Coming Soon
tutorial	Prerequisites, Steps, Next Steps	Steps, Step, CodeGroup, Tip, Warning, Check	Coming Soon
concept	Overview	Accordion, AccordionGroup, CodeGroup, Tabs, Note, Info, Tip	TODO/TBD placeholders
resource	Overview or H2 sections	Card, CardGroup, Table, Accordion, AccordionGroup, Note	TODO/TBD placeholders
faq	Frequently Asked Questions	Accordion, AccordionGroup, Note, Info, Tip	TODO/TBD placeholders
troubleshooting	Fix, Verify	Accordion, AccordionGroup, CodeGroup, Tabs, Warning, Check	TODO/TBD/Coming Soon
glossary	Terms	Accordion, AccordionGroup, Table, Note, Info	TODO/TBD placeholders
changelog	Changes	Accordion, AccordionGroup, CodeGroup, Note, Info	TODO/TBD placeholders

Validation Command

node operations/scripts/validators/components/library/component-layout-governance.js --scope full --output-dir workspace/reports/repo-ops