Configuration requirements and dependencies should be made explicit and prominent in documentation, not buried in notes or admonitions. When introducing new configuration options or requirements, ensure they are clearly documented as prerequisites or explicit steps rather than side notes that users might miss.
Key practices:
Example of good practice:
# Clear prerequisite documentation
## Prerequisites
- Teleport role version 8 requires app_labels configuration
- Ensure your role allows access with proper label matching
## Step X: Configure Access
Configure the required app_labels for RBAC:
```yaml
allow:
app_labels:
'teleport.dev/origin': 'aws-identity-center'
This approach ensures users understand configuration requirements upfront rather than discovering them through error messages or buried documentation notes.
Enter the URL of a public GitHub repository