> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
node operations/scripts/validators/components/library/component-layout-governance.js --scope full --output-dir workspace/reports/repo-ops
```