Repository navigation
docs(walkthroughs): document the area tours and why findings close and reopen - #16382
Merged
Merged
Conversation
Adds a section to the Reimport page on the commonest reimport question: where the evidence is (Import History's closed and reactivated counts, and the note each Reimport writes on a Finding it closes or reopens), the three causes behind most cases (a partial scan reimported into a Test holding a full one, a Finding closed by hand while the scanner still reports it, and a Finding whose location moved), and Do Not Reactivate for a scanner triaged elsewhere.
The In-App Walkthroughs page described only the App Tour. A new Tours by area section lists the eleven area tours: where the lightbulb lists each one, what it covers, and who sees it (the feature and permission each is gated on, and the steps a missing permission skips).
Maffooch
approved these changes
Oct 17, 2026
devGregA
approved these changes
Oct 17, 2026
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
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.
Description
Documents the first wave of in-app tours, in two pages.
In-App Walkthroughs (
docs/content/navigation/PRO__walkthroughs.md): a new "Tours by area" section. The page described only the App Tour; the section lists the eleven area tours in one table, with where the lightbulb lists each one, what it covers, and who sees it (the feature and permission each is gated on, and the steps a missing permission skips). The tours are Why Findings Close and Reopen; Organizations, Assets, Engagements and Tests; Finding Statuses, SLAs and Risk Acceptance; The Findings List; Exporting Findings; API Access; Reports; SSO and Login; Classic Jira or the Jira Connector; Locations; and Upstream Connectors.Reimport (
docs/content/import_data/import_intro/reimport.md): a new "Why Findings Close and Reopen" section, for the most common reimport question, a Finding that keeps closing and coming back. It says where the evidence is:It then covers the three causes behind most cases:
It ends with Do Not Reactivate for a scanner that is triaged elsewhere. The section links only to anchors already on the same page (Actions, Reimport Deduplication, Reopen Findings), and the reimport tour's last card links to its anchor,
#why-findings-close-and-reopen.Every other tour card links to a docs section that already exists; each of those anchors was checked on docs.defectdojo.com.
English only: the language copies of the docs are translated automatically.
Testing
Docs only. Each reimport claim was checked against the reimport code on
dev(Close Old Findings on by default for Reimport, the two note texts, the statuses Reimport never reopens, Do Not Reactivate). Each row of the tours table was checked against the tour's definition: its pages, its feature flag and permission, and its per-step gates. The Hugo site was not built locally.🤖 Generated with Claude Code