Skip to content

[FFL-2385] Add Stale Flags concept page#37279

Merged
abin-ddhq merged 8 commits into
masterfrom
abin/ffl-2385-stale-flags-docs
Jun 15, 2026
Merged

[FFL-2385] Add Stale Flags concept page#37279
abin-ddhq merged 8 commits into
masterfrom
abin/ffl-2385-stale-flags-docs

Conversation

@abin-ddhq

Copy link
Copy Markdown
Contributor

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:

  • Ready for merge

Additional notes

Made with Cursor

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>
@abin-ddhq abin-ddhq requested a review from a team as a code owner June 4, 2026 20:35
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Jun 4, 2026
@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

@dd-octo-sts-c33ac5

dd-octo-sts-c33ac5 Bot commented Jun 4, 2026

Copy link
Copy Markdown

🐑 PR Shepherd is maintaining this PR

I 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 flow-skip label.

@OliviaShoup OliviaShoup left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for the PR! it looks great. left some non-blocking suggestions

Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated
Comment thread content/en/feature_flags/concepts/stale_flags.md Outdated

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/feature-flags

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems most of the other pages do this though? At least according to claude running over it all. Is this a new convention?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah this comment was a mistake. sorry about that. yeah it's extremely common! my freaking Claude did this lol

abin-ddhq and others added 6 commits June 4, 2026 18:49
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>
- Align the "Generate a removal PR" heading with the actual UI button label (drop "AI")
- Add trailing periods to alt text on generate_removal_pr and mark_as_permanent images
- "killswitches" -> "kill switches"

Co-authored-by: Cursor <cursoragent@cursor.com>
@abin-ddhq abin-ddhq merged commit 8f4f551 into master Jun 15, 2026
20 checks passed
@abin-ddhq abin-ddhq deleted the abin/ffl-2385-stale-flags-docs branch June 15, 2026 17:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants