Document Alpha, Beta, LA features
Some features are not generally available and are instead considered Alpha, Beta, or Limited Availability.
When you document a feature in one of these three statuses:
(Limited Availability)in parentheses after the page or topic title.
- Do not include
(Limited Availability)in the left nav.
- Ensure the version history lists the feature’s status.
These features are usually behind a feature flag, which follow these documentation guidelines.
If you add details of how users should enroll, or how to contact the team with issues,
FLAG: note should be above these details. For example:
## Great new feature (Alpha) FLAG: On self-managed GitLab, by default this feature is not available. To make it available, ask an administrator to enable the feature flag named example_flag. On GitLab.com, this feature is not available. This feature is not ready for production use. Use this great new feature when you need to do this new thing. This feature is in Alpha. To join the list of users testing this feature, do this thing. If you find a bug, [open an issue](link).
When the feature is released, remove:
- The text in parentheses.
- Any language about the feature not being ready for production.
- The feature flag information.
Ensure the version history is up-to-date.