docs(incidents): record six production incidents and cross-link the rules

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing Guide
 
-Thank you for your interest in contributing. ECHO is an open source project. If you are interested in making it better, there are many ways you can contribute. For example, you can:
+Thank you for your interest in contributing. dembrane is an open source project. If you are interested in making it better, there are many ways you can contribute. For example, you can:
 
 - Submit a bug report
 - Suggest a new feature

README.md

@@ -2,6 +2,8 @@
 
 dembrane is a transcription, analysis (sense-making) and reporting platform built for in-person, multilingual conversations. It's a complete solution for real-world stakeholder-engagement scenarios where reliability and ease of use matter. dembrane started under a "move fast and break things" philosophy while serving early partners. To better serve the public, we're moving to a privacy-first and security-first approach.
 
+> dembrane was formerly called ECHO. The old name still turns up in a few places, including this repository's name, its container images, and its Kubernetes namespaces.
+
 <table>
   <tr>
     <td align="center">
@@ -64,7 +66,7 @@ We offer several ways to get started:
 
 ## Documentation
 
-- [User guide / documentation](https://docs.dembrane.com) (built from the `echo-user-docs` folder)
+- [User guide / documentation](https://docs.dembrane.com) (built from the `docs` folder)
 - [Developer documentation](echo/readme.md)
 
 ## For those considering a fork

docs/README.md

@@ -15,6 +15,9 @@ We build on one belief: *people know how.* Communities already hold the knowledg
 solve their own challenges. dembrane doesn't add intelligence to a group - it surfaces the
 intelligence already there, and keeps the humans in the room firmly in charge.
 
+dembrane was formerly called ECHO. The old name still turns up here and there, in file
+paths, image names, and older material.
+
 > [!NOTE]
 > New here? The fastest path is the *[Quick start for hosts](./users/host/getting-started.md)*.
 > Just here to record on someone's invitation? See *[for participants](./users/participant/index.md)*.

docs/README.nl-NL.md

@@ -17,6 +17,9 @@ hun eigen uitdagingen op te lossen. dembrane voegt geen intelligentie toe aan ee
 het brengt de intelligentie naar boven die er al is, en houdt de mensen in de kamer stevig
 aan het roer.
 
+dembrane heette vroeger ECHO. Die oude naam duikt hier en daar nog op, in bestandspaden,
+image-namen en ouder materiaal.
+
 > [!NOTE]
 > Nieuw hier? De snelste route is de *[Snelstart voor hosts](./users/host/getting-started.md)*.
 > Alleen hier om op te nemen op uitnodiging? Zie *[voor deelnemers](./users/participant/index.md)*.

docs/_authoring/FACTS.md

@@ -17,9 +17,11 @@ and turns hours of dialogue into summaries, themes, reports, and a chat you can
 interrogate. Core belief: *"PEOPLE KNOW HOW"* - communities already hold the
 knowledge; dembrane surfaces it.
 
-"ECHO" is the historical name of the platform feature. It is *not* the brand and
-should be used sparingly. The brand is always *dembrane* (lowercase). In new docs,
-prefer "dembrane" / "the dashboard" / "the portal" over "ECHO".
+"ECHO" is the legacy platform name. The brand is always *dembrane* (lowercase); its
+parts are "the dashboard", "the portal", "the recorder". Do not use "ECHO" in docs
+prose. The single "formerly ECHO" note lives on `docs/README.md`. The one live
+exception is the participant record button, still labelled "ECHO" in the portal UI
+(msgid `participant.button.echo`): describe that button as the UI labels it.
 
 The product ships three ways:
 1. *Managed SaaS* at dembrane.com (dashboard.dembrane.com + portal.dembrane.com).
@@ -425,9 +427,11 @@ ADRs in `echo/docs/adr/`.
    Library, Reporting a Bug, Compliance & Trust), toggles for Setting-up a project /
    Recording / Analysing / Templates / Ready-Check-Go / Designing a session / Upload docs.
    Also links to docs.dembrane.com for First Aid + bug reporting.
-2. *docs.dembrane.com* = the Nextra site `echo-user-docs/` (en-US + nl-NL): Getting Started
-   (creating-project, collecting-data, analysis), Core Concepts, First Aid, Avoiding Pitfalls
-   (technical, social). Thin, "under construction", off-brand ("ECHO").
+2. *The retired Nextra site* `echo-user-docs/` (en-US + nl-NL), which served
+   docs.dembrane.com until 2026-07-30: Getting Started (creating-project, collecting-data,
+   analysis), Core Concepts, First Aid, Avoiding Pitfalls (technical, social). Thin, "under
+   construction", off-brand ("ECHO"). docs.dembrane.com now serves this `docs/` corpus,
+   published from `main` by `.github/workflows/deploy-docs.yml`.
 3. *echo/docs/* = developer/internal docs (ADRs, plans, issues, litellm config, migrations).
 
 These are the baseline our new docs replace: comprehensive, role-segmented, on-brand,

docs/_authoring/STYLE.md

@@ -4,8 +4,10 @@ Read `FACTS.md` first for what is true. This file is HOW to write it.
 
 ## Brand voice
 - Always lowercase *dembrane* - even at the start of a sentence/heading.
-- "ECHO" is the old platform-feature name. *Avoid it.* Say "dembrane", "the dashboard",
-  "the portal", "the recorder". Only mention ECHO once, in passing, if disambiguating.
+- "ECHO" is the legacy platform name. *Avoid it.* Say "dembrane", "the dashboard",
+  "the portal", "the recorder". The single "formerly ECHO" note lives on `docs/README.md`;
+  don't add more. Exception: the participant record button is still labelled "ECHO" in the
+  portal UI, so a page describing that button matches the UI.
 - Tone: approachable, grounded, human. 80% Everyman, 20% Explorer (IKEA meets Patagonia).
   Plain language, short sentences. Respect the reader's intelligence; never hype.
 - Core belief to echo where natural: *PEOPLE KNOW HOW* - dembrane surfaces the

docs/users/developer-external/index.md

@@ -33,9 +33,9 @@ licence. The full terms, the threshold, and who to contact are on the
 [licensing](./licensing.md) page - read it before you deploy.
 
 > [!NOTE]
-> "ECHO" is the historical internal name of the platform feature and still appears in some
-> file paths and older docs. The brand is dembrane. We use "dembrane", "the dashboard",
-> and "the portal" throughout these guides.
+> dembrane was formerly called ECHO, so the old name still shows up in the repository name,
+> container images, and Kubernetes namespaces. These guides say "dembrane", "the dashboard",
+> and "the portal".
 
 ## The three ways to run dembrane
 

docs/users/host/getting-started.md

@@ -26,7 +26,7 @@ recommended, not required.)
 
 Once signed in, you will see your main dashboard:
 - *The sidebar* - The sidebar on the left lets you quickly navigate between your Organisation, Workspaces, and Projects.
-- *Sidebar collapse* - To give yourself more screen space when reading transcripts or analysing data, you can collapse the sidebar entirely. Look for the *Sidebar Toggle* (the left-pointing chevron) in the sidebar header, top-right by the logo, to slide it closed. Clicking the toggle again expands it back.
+- *Sidebar collapse* - To give yourself more screen space when reading transcripts or analysing data, you can collapse the sidebar entirely. Look for the *Sidebar Toggle* (the sidebar icon) in the sidebar header, top-right by the logo, to slide it closed. Clicking the toggle again expands it back.
 - *Collapse persistence* - The collapsed state persists (saved in your browser's local storage), so the sidebar stays exactly how you left it when you return or sign in again.
 
 ## 2. Create a project

echo/agent/README.md

@@ -1,4 +1,4 @@
-# Echo Agent Service
+# dembrane agent service
 
 Isolated CopilotKit/LangGraph runtime for Agentic Chat.
 

echo/frontend/README.md

@@ -1,4 +1,4 @@
-# Dembrane ECHO Frontend
+# dembrane frontend
 
 ## Getting Started