[FFL-2385] Add Stale Flags concept page#37279
Open
abin-ddhq wants to merge 7 commits into
Open
Conversation
Adds a new concept page documenting how Datadog detects and surfaces stale feature flags, plus the in-product actions to resolve them (Generate Removal PR with Bits, Archive, Mark as Permanent, Dismiss). Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Preview links (active after the
|
🐑 PR Shepherd is maintaining this PRI watch your PR and automatically fix CI failures, rebase your branch, handle flaky tests, and push it to the merge queue when it's ready. More about what I do → Guide To pause me on this PR, add the |
OliviaShoup
approved these changes
Jun 4, 2026
Contributor
OliviaShoup
left a comment
OliviaShoup
left a comment
There was a problem hiding this comment.
thanks for the PR! it looks great. left some non-blocking suggestions
|
|
||
| ## Manage stale flags | ||
|
|
||
| ### Generate a removal PR with Bits AI |
Contributor
There was a problem hiding this comment.
The heading says "Bits AI," but the button label below (and the modal alt text) read "Generate Removal PR with Bits." Worth confirming the actual UI label and aligning the heading with it — if the feature is branded "Bits AI," keep it; if the button literally reads "Bits," match that.
|
|
||
| **Note**: Remove the flag from your code and deploy the change before you archive the flag. Archiving a flag that is still referenced in code can cause unexpected behavior in your application. | ||
|
|
||
| {{< img src="feature_flags/generate_removal_pr.png" alt="Generate Removal PR with Bits modal" style="width:100%;" >}} |
Contributor
There was a problem hiding this comment.
Alt text should end with a period.
Suggested change
| {{< img src="feature_flags/generate_removal_pr.png" alt="Generate Removal PR with Bits modal" style="width:100%;" >}} | |
| {{< img src="feature_flags/generate_removal_pr.png" alt="Generate Removal PR with Bits modal." style="width:100%;" >}} |
|
|
||
| ### Mark as permanent | ||
|
|
||
| Some flags are intentionally long-lived, such as killswitches or permission gates. Select {{< ui >}}Mark as Permanent{{< /ui >}} on the stale banner to designate a flag as a permanent operational control and exclude it from future stale detection. Permanent flags show a {{< ui >}}PERMANENT{{< /ui >}} indicator in the flag details sidebar. |
Contributor
There was a problem hiding this comment.
kill switches is two words (per Merriam-Webster):
Suggested change
| Some flags are intentionally long-lived, such as killswitches or permission gates. Select {{< ui >}}Mark as Permanent{{< /ui >}} on the stale banner to designate a flag as a permanent operational control and exclude it from future stale detection. Permanent flags show a {{< ui >}}PERMANENT{{< /ui >}} indicator in the flag details sidebar. | |
| Some flags are intentionally long-lived, such as kill switches or permission gates. Select {{< ui >}}Mark as Permanent{{< /ui >}} on the stale banner to designate a flag as a permanent operational control and exclude it from future stale detection. Permanent flags show a {{< ui >}}PERMANENT{{< /ui >}} indicator in the flag details sidebar. |
|
|
||
| Some flags are intentionally long-lived, such as killswitches or permission gates. Select {{< ui >}}Mark as Permanent{{< /ui >}} on the stale banner to designate a flag as a permanent operational control and exclude it from future stale detection. Permanent flags show a {{< ui >}}PERMANENT{{< /ui >}} indicator in the flag details sidebar. | ||
|
|
||
| {{< img src="feature_flags/mark_as_permanent.png" alt="Feature flag marked as PERMANENT on the flag details page" style="width:100%;" >}} |
Contributor
There was a problem hiding this comment.
Alt text should end with a period.
Suggested change
| {{< img src="feature_flags/mark_as_permanent.png" alt="Feature flag marked as PERMANENT on the flag details page" style="width:100%;" >}} | |
| {{< img src="feature_flags/mark_as_permanent.png" alt="Feature flag marked as PERMANENT on the flag details page." style="width:100%;" >}} |
|
|
||
| {{< partial name="whats-next/whats-next.html" >}} | ||
|
|
||
| [1]: https://app.datadoghq.com/feature-flags |
Contributor
There was a problem hiding this comment.
Couldn't verify this link from here (the page is auth-gated). Worth confirming /feature-flags resolves — and note that a hardcoded app.datadoghq.com link sends EU/US3/etc. users to the US1 site rather than their own.
Co-authored-by: Olivia Shoup <116908616+OliviaShoup@users.noreply.github.com>
Co-authored-by: Olivia Shoup <116908616+OliviaShoup@users.noreply.github.com>
Co-authored-by: Olivia Shoup <116908616+OliviaShoup@users.noreply.github.com>
Co-authored-by: Olivia Shoup <116908616+OliviaShoup@users.noreply.github.com>
Co-authored-by: Olivia Shoup <116908616+OliviaShoup@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Fixes FFL-2385
Adds a new "Stale Flags" page under
content/en/feature_flags/concepts/documenting how Datadog detects stale feature flags, the three staleness signals (Fully rolled out, No evaluations, No activity), and the per-flag actions available from the stale banner: Generate Removal PR with Bits, Archive, Mark as Permanent, and Dismiss for 30 days.Also adds the new page to the concepts index.
Merge instructions
Merge readiness:
Additional notes
Made with Cursor