Commit 4d470771 authored by Russell Dickenson's avatar Russell Dickenson

Merge branch 'eread/cross-link-between-feature-flag-documentation' into 'master'

Cross link between feature flag guidance

Closes #34854

See merge request gitlab-org/gitlab!19198
parents aeb20d58 3f02eee5
...@@ -1055,7 +1055,7 @@ Sometimes features are shipped with feature flags, either: ...@@ -1055,7 +1055,7 @@ Sometimes features are shipped with feature flags, either:
- On by default, but providing the option to turn the feature off. - On by default, but providing the option to turn the feature off.
- Off by default, but providing the option to turn the feature on. - Off by default, but providing the option to turn the feature on.
When documenting feature flags for a feature, it's important that users know: When documenting feature flags for a feature, include:
- Why a feature flag is necessary. Some of the reasons are - Why a feature flag is necessary. Some of the reasons are
[outlined in the handbook](https://about.gitlab.com/handbook/product/#alpha-beta-ga). [outlined in the handbook](https://about.gitlab.com/handbook/product/#alpha-beta-ga).
...@@ -1080,6 +1080,9 @@ Feature.disable(:feature_flag) ...@@ -1080,6 +1080,9 @@ Feature.disable(:feature_flag)
``` ```
```` ````
For guidance on developing with feature flags, see
[Feature flags in development of GitLab](../feature_flags/index.md).
## API ## API
Here is a list of must-have items. Use them in the exact order that appears Here is a list of must-have items. Use them in the exact order that appears
......
...@@ -10,3 +10,6 @@ Before using feature flags for GitLab's development, read through the following: ...@@ -10,3 +10,6 @@ Before using feature flags for GitLab's development, read through the following:
- [Process for using features flags](process.md). - [Process for using features flags](process.md).
- [Developing with feature flags](development.md). - [Developing with feature flags](development.md).
- [Controlling feature flags](controls.md). - [Controlling feature flags](controls.md).
When documenting feature flags, see [Feature flags](../documentation/styleguide.md#feature-flags)
in the Documentation Style Guide.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment