[AdamGohs]

Description

Starts the Dam Screening Tool User's Guide from scratch (the earlier unreviewed draft was removed in #144), beginning with the Dashboard. This is a draft to show the direction the guide will take.

In this PR

• Front matter: Document Info, Version History, Preface.
• Chapter 3, Getting Started, covering the Dashboard:
  • the My Screenings, My Reviews and Search Catalog tabs
  • creating a screening, including the NID dam search and USACE dams
  • copying and renaming screenings
  • managing the screening team
  • requesting access to other screenings
• Seven screenshots with numbered callouts and full alt text.
• The guide is registered as an active draft, with sidebar_label "Dam Screening Tool User's Guide".

How the guide is built

• Organized by the screening workflow, not the code. One chapter per nav tab, an H2 per page or sub-tab, an H3 per page section.
• Cross-cutting behavior is explained once. Auto-save, automatic calculation, message banners, verification, input lock, editing conflicts, grids and Submission Readiness get one shared chapter (Chapter 4, Working in DST), and every page chapter links to it instead of repeating it.
• Planned chapters:
  • 02 Introduction
  • 03 Getting Started (sign-in and Profile still to come)
  • 04 Working in DST
  • 05 Screening Information
  • 06 Hazards
  • 07 Dam Information
  • 08 Cross-Section Editors
  • 09 Failure Mode Screening and Selection
  • 10 Failure Mode Evaluation (everything the PFM pages share)
  • one thin chapter per PFM
  • User-Defined PFM
  • Consequences
  • Risk Analysis
  • Major Findings
  • Documents
  • Review
  • References and appendices (acronyms, glossary, PFM quick reference)
• Every input is documented: exact label, whether it is required, and one sentence on what it feeds. Methodology stays in the Technical Reference Manual, and engineering judgment stays in the Applications Guide.
• Screenshots are reproducible and use only fictional data. They were captured at 1920×1080 from a scratch DST stack seeded with fictional "Example" dams and generic seed accounts, never from a working database. Each one is recorded in a shot list so it can be recaptured when the UI changes. Callouts are steel blue, never red.

Document scope

• Document: Dam Screening Tool User's Guide
• Document location (doc_location, or -): web-applications/dst/users-guide

Related issue(s)

None.

Validation

• I previewed the change locally or through the PR preview
• I ran the checks appropriate to this change
• I updated version history when the document revision warrants it (initial version)

DOCS_MODE=prod npm run build passes, and the chapter was checked in a local build of the site.

Review notes

New document: Lane 1. Draft, opened for early feedback on structure, tone and figure style before more chapters are written. References to Chapter 4 (Working in DST) and Chapter 27 (Review) are plain text until those chapters exist.

[usace-rmc-docs-review]

Review workflow

Purpose: content · Classification: awaiting administrator assignment
Document: not selected

Stage	Reviewer	Status

Next: Administrator: classify this PR

Review preview: https://usace-rmc.github.io/RMC-Software-Documentation-Previews/pr-161/
Preview revision: 8071e731ca4d71dc0adc98568dd561a39d6271fe

Completed stages persist until an administrator restarts them. Replies and resolved threads are not approval requirements. Use /review ready to request re-review within an active stage.

[usace-rmc-docs-review]

@USACE-RMC/docs-admin — classify this PR with /review classify <lane> <document|->. Builds run while classification is pending.