[Content] Start the Dam Screening Tool User's Guide with the Dashboard

docs/web-applications/dst/users-guide/v1.0/00-document-info.mdx

@@ -0,0 +1,20 @@
+---
+title: Document Info
+reportDate: October 2026
+reportType: Computer Program Document
+reportTitle: Dam Screening Tool
+reportSubTitle: User's Guide
+reportAuthors: ['Adam Gohs, P.E.']
+reportAbstract: The Dam Screening Tool (DST) is a web application for screening-level risk analysis of dams. This User's Guide explains how to operate DST to create a screening, enter its information, evaluate its potential failure modes, assemble its risk results and take it through review. It documents every page, input and status indicator in the application and the workflow that connects them. The engineering methods behind the calculations are documented separately in the DST Technical Reference Manual and the System Response Library manuals.
+reportSubjectTerms: ['Dam Screening Tool', 'DST', 'Dam Safety', 'Screening-Level Risk Analysis', 'Potential Failure Mode', 'Web Application', "User's Guide"]
+citationGuide: "U.S. Army Corps of Engineers, Risk Management Center, <i>Dam Screening Tool User's Guide</i>, Lakewood, CO: U.S. Army Corps of Engineers, Risk Management Center, 2026."
+---
+
+import DocumentMetadata from '@site/src/components/DocumentMetadata';
+import NavContainer from '@site/src/components/NavContainer';
+
+<NavContainer link="/web-applications/dst" linkTitle="Dam Screening Tool" document="web-applications/dst/users-guide" />
+
+# Document Information
+
+<DocumentMetadata metadata={frontMatter} />

docs/web-applications/dst/users-guide/v1.0/00-version-history.mdx

@@ -0,0 +1,19 @@
+---
+title: Version History
+---
+
+import NavContainer from '@site/src/components/NavContainer';
+import TableVersionHistory from '@site/src/components/TableVersionHistory';
+
+<NavContainer link="/web-applications/dst" linkTitle="Dam Screening Tool" document="web-applications/dst/users-guide" />
+
+# Version History
+
+<TableVersionHistory
+  versions={['1.0']}
+  dates={['October 2026']}
+  descriptions={['Initial release as an online document.']}
+  modifiedBy={['-']}
+  reviewedBy={['-']}
+  approvedBy={['-']}
+/>

docs/web-applications/dst/users-guide/v1.0/01-preface.mdx

@@ -0,0 +1,32 @@
+---
+title: Preface
+---
+
+import NavContainer from '@site/src/components/NavContainer';
+
+<NavContainer link="/web-applications/dst" linkTitle="Dam Screening Tool" document="web-applications/dst/users-guide" />
+
+# Preface
+
+The Dam Screening Tool (DST) is a web application for screening-level risk analysis of dams. This User's Guide explains how to operate DST: how to
+create a screening, enter its information, evaluate its potential failure modes, assemble its risk results, and take it through review. It documents
+each page, input and status indicator in the application, and the workflow that connects them.
+
+The guide is written for dam safety engineers and analysts who build screenings, and for the reviewers who read and comment on them. It assumes a
+working knowledge of dam safety risk analysis; terms specific to the DST interface are defined where they first appear.
+
+The User's Guide describes how to use DST, not the engineering behind it. The calculations DST performs are documented in the DST Technical Reference
+Manual and in the System Response Library manuals for each screening model.
+
+## Document Organization
+
+- **[Chapter 2, Introduction](./02-introduction.mdx)** — what DST is, what a screening-level risk analysis is, and the modules of a screening in
+  workflow order.
+- **[Chapter 3, Getting Started](./03-getting-started.mdx)** — the Dashboard, creating and copying screenings, the screening team, and requesting
+  access to other screenings.
+- **[Chapter 4, Working in DST](./04-working-in-dst.mdx)** — navigation, automatic saving and calculation, messages, tables, verification,
+  Submission Readiness, the input lock and editing conflicts, shared by every screening page.
+
+## Contact Us
+
+For questions or concerns, please email RMC.Software@usace.army.mil.

docs/web-applications/dst/users-guide/v1.0/02-introduction.mdx

@@ -0,0 +1,91 @@
+---
+title: Introduction
+---
+
+import Figure from '@site/src/components/Figure';
+import FigReference from '@site/src/components/FigureReference';
+import NavContainer from '@site/src/components/NavContainer';
+import TableReference from '@site/src/components/TableReference';
+import TableVertical from '@site/src/components/TableVertical';
+
+<NavContainer link="/web-applications/dst" linkTitle="Dam Screening Tool" document="web-applications/dst/users-guide" />
+
+# Introduction
+
+The Dam Screening Tool (DST) is a web application for screening-level risk analysis of dams. A screening team uses DST to characterize the hazards
+loading a dam, identify and evaluate the dam's potential failure modes, estimate the consequences of failure, and combine those pieces into risk
+estimates. The team then records its findings and takes the screening through review, all within the same application.
+
+All of a dam's work in DST is organized as a **screening**. A screening holds everything the team enters, every result DST produces for that dam, and
+the screening's review history. Each screening has a team led by a Facilitator, and every page of the screening is open to the team at the same time.
+
+## Screening-Level Risk Analysis
+
+A screening-level risk analysis estimates a dam's risk from the information readily available for the dam and the judgment of the screening team. DST
+supplies a consistent structure for that work. Expert-developed screening logic recommends which potential failure modes to evaluate, structured
+workflows estimate the system response for each one, and integrated services perform the hydraulic, consequence and risk computations.
+
+DST reports risk estimates; it does not make dam safety decisions. The results carry the level of detail of the information and judgment behind them,
+and they are not a substitute for a detailed risk assessment. How DST computes each result, and the assumptions and limitations of each method, are
+documented in the DST Technical Reference Manual and in the System Response Library manuals for each screening model.
+
+DST supports two types of screening. An **Official** screening is a screening of record that can be submitted for review. A **Testing** screening is
+for practice and training; it cannot be submitted for review or produce official reports.
+
+## The Screening Workflow
+
+Inside a screening, the module navigation on the left of the page lists the screening's modules in workflow order
+(<FigReference figKey="dst-users-guide-fig-screening-modules-nav" />). <TableReference tableKey="dst-users-guide-table-screening-modules" /> summarizes
+what the team does in each module and which later modules use the result.
+
+<Figure
+  figKey="dst-users-guide-fig-screening-modules-nav"
+  src="figures/web-applications/dst/users-guide/v1.0/figures/screening-modules-nav.png"
+  alt="The module navigation of a screening, on a dark steel-blue background. At the top is the screening name, 'FY27 Screening — Example Dam', with a button to collapse the navigation. Below it are eight modules, each with an icon: Screening Information (selected and highlighted), Documents, Hazards, Response, Consequences, Risk Analysis, Major Findings and Review."
+  caption="The module navigation of a screening."
+  width="25%"
+/>
+
+<TableVertical
+  tableKey="dst-users-guide-table-screening-modules"
+  colWidths={['22ch', 'minmax(24ch, 1fr)', 'minmax(30ch, 2fr)']}
+  alt="The modules of a screening, the pages each contains, and what the team does in each"
+  caption="Screening modules"
+  headers={[[{ value: 'Module' }, { value: 'Pages' }, { value: 'What the team does' }]]}
+  columns={[
+    ['Screening Information', 'Documents', 'Hazards', 'Response', 'Consequences', 'Risk Analysis', 'Major Findings', 'Review'],
+    [
+      'Overview, Screening Management, Dam Data, Operational Data, Screening Activity',
+      'Documents',
+      'Hydrologic Hazard, Stage Duration, Seismic Hazard',
+      'Dam Information, Failure Mode Screening, Failure Mode Selection, Failure Mode Evaluation',
+      'Inundation Geometry, Inundation Analysis, Consequence Data, LifeSim Compute, Consequence Results',
+      'Setup, Results',
+      'Risk Characterization, Major Uncertainties, Summary of Findings, Recommendations',
+      'Submission Readiness, Review Levels',
+    ],
+    [
+      'Records the screening details, the screening team and review levels, the dam data, and the reservoir operating data used by later modules.',
+      'Stores the reports, drawings and other files the team relies on.',
+      'Defines the hydrologic loading, the reservoir stage-duration relationship and the seismic loading on the dam.',
+      'Describes the dam\'s materials and cross sections, screens and selects the potential failure modes, and estimates the system response of each selected failure mode.',
+      'Models the dam breach and the resulting inundation with HEC-RAS, and estimates life loss and economic damages with LifeSim.',
+      'Combines the hazard, system response and consequence results into risk estimates for each failure mode and for the dam with RMC-TotalRisk.',
+      'Characterizes the risk, documents the major uncertainties, and records the team\'s findings and recommendations.',
+      'Confirms the screening is ready, submits it for review, and takes it through each review level to completion.',
+    ],
+  ]}
+/>
+
+The modules are not a strict sequence. The team may work in any module at any time, and several team members may work in different modules at once.
+Results that depend on earlier modules recalculate automatically when their inputs change, and a team member verifies the data on each page once it is
+complete. These shared behaviors are described in [Chapter 4, Working in DST](./04-working-in-dst.mdx).
+
+## Using This Guide
+
+[Chapter 3, Getting Started](./03-getting-started.mdx), describes the Dashboard, creating a screening and managing the screening team. [Chapter 4, Working in DST](./04-working-in-dst.mdx), describes the
+navigation and the behaviors shared by every screening page. The chapters after it follow the module order in
+<TableReference tableKey="dst-users-guide-table-screening-modules" />, and the Review chapter is written for reviewers as well as screening teams.
+
+The guide names pages, tabs, buttons and fields exactly as they appear in DST, in **bold** where the user selects or enters them. The figures show
+fictional screenings and, where a dam is taken from the National Inventory of Dams, public data for that dam.