fix: remove hard-coded colors from Mermaid diagrams for dark mode readability

ISSUES-ASSESSMENT.md

@@ -0,0 +1,64 @@
+# Issues Assessment
+
+## Summary
+
+| Issue | Title | Labels | Verdict | Complexity |
+|-------|-------|--------|---------|------------|
+| #694 | Mermaid diagrams unreadable in dark mode | DMB | In-repo | Medium |
+| #661 | SRU requirements should link to reference/requirements | SRU | In-repo | Low |
+| #645 | Missing Futures Release update in list of releases | Release team | In-repo | Low |
+| #634 | Convert Ubuntu governance model to Mermaid | TB, community | In-repo (PR #687 exists) | Medium |
+| #641 | snapshots missing | — | Out-of-repo | — |
+| #640 | Upload a PPA page needs help | — | Out-of-repo | — |
+| #607 | Apps installed from Edge/Chrome icon issue | — | Out-of-repo | — |
+| #592 | SRU standard-process clean up | SRU | Skipped (SRU label, requires investigation) | — |
+| #587 | Expand SRU examples | SRU | Skipped (SRU label, requires investigation) | — |
+| #543 | Refresh Snapd special case documentation | SRU, TB | Skipped (SRU+TB labels, requires Launchpad MP investigation) | — |
+| #540 | Improvements to Apport content | — | Skipped (requires investigation for replacement URLs) | — |
+| #536 | Build packages locally: address prior revision comments | — | Skipped (requires technical investigation of PR comments) | — |
+| #521 | Flavours? (seed management) | Release team | Skipped (Release team label, requires investigation) | — |
+| #520 | Platform vs ubuntu repositories? | Release team | Skipped (Release team label, requires investigation) | — |
+| #516 | Request to add rsync page | community | Out-of-repo | — |
+| #509 | SRU broken link (ubuntu-image) | SRU | Skipped (SRU label, replacement URL not provided) | — |
+| #507 | SRU broken link (postgres) | SRU | Skipped (SRU label, replacement URL not provided) | — |
+| #506 | SRU broken link (postfix) | SRU | Skipped (SRU label, replacement URL not provided) | — |
+| #490 | Outdated information in Ubuntu Bug Control | — | Skipped (requires investigation for replacement contact) | — |
+| #479 | Request to add Boot-Info page | documentation | Out-of-repo | — |
+
+## In-repo issues to fix
+
+### #694 — Mermaid diagrams unreadable in dark mode
+
+- **Task**: Remove hard-coded colors from all Mermaid diagrams so they use default theme (adapts to light/dark mode)
+- **Files** (12 total):
+  - `docs/how-ubuntu-is-made/processes/lifecycle-of-a-change.txt`
+  - `docs/how-ubuntu-is-made/processes/lifecycle-1-report-triage.txt`
+  - `docs/how-ubuntu-is-made/processes/lifecycle-2-prepare-test.txt`
+  - `docs/how-ubuntu-is-made/processes/lifecycle-3-propose-review.txt`
+  - `docs/how-ubuntu-is-made/processes/lifecycle-4-upload-sponsor.txt`
+  - `docs/how-ubuntu-is-made/processes/lifecycle-5-proposed-migration.txt`
+  - `docs/who-makes-ubuntu/developers/diagrams/overall-path.txt`
+  - `docs/who-makes-ubuntu/developers/diagrams/basics.txt`
+  - `docs/who-makes-ubuntu/developers/diagrams/intermediate.txt`
+  - `docs/who-makes-ubuntu/developers/diagrams/advanced.txt`
+  - `docs/who-makes-ubuntu/developers/diagrams/expert.txt`
+  - `docs/MIR/mir-process-states.md`
+- **Resolution**: Remove all `fill:#`, `stroke:#`, `background:#`, `classDef`, and `style` lines from mermaid diagrams
+
+### #661 — SRU requirements should link to reference/requirements
+
+- **Task**: Add cross-reference from explanation requirements page to reference requirements page
+- **Files**: `docs/SRU/explanation/requirements.rst`
+- **Resolution**: Add a `.. seealso::` directive or note linking to `docs/SRU/reference/requirements.rst`
+
+### #645 — Missing Futures Release update in list of releases
+
+- **Task**: Add Ubuntu 26.04.1 LTS to Future releases table
+- **Files**: `docs/release-team/list-of-releases.md`
+- **Resolution**: Add row for Ubuntu 26.04.1 LTS (Resolute Raccoon) with TBD for unknown fields, May 2031 for End of Standard Support
+
+### #634 — Convert Ubuntu governance model to Mermaid
+
+- **Task**: Convert governance map PNG to Mermaid diagram (PR #687 exists as draft, needs fixing — uses hard-coded colors)
+- **Files**: `docs/community/governance/index.md`
+- **Resolution**: Update PR #687 to remove hard-coded colors from the Mermaid diagram

docs/.sphinx/_static/custom_styles.css

@@ -1,15 +1,17 @@
-.codeblock-wrap pre { white-space:pre-wrap; }
+.codeblock-wrap pre {
+  white-space: pre-wrap;
+}
 
 pre.mermaid svg {
-    width: 70% !important;
-    height: auto !important;
+  width: 100% !important;
+  height: auto !important;
 }
 
 /* Append "(in this article)" dynamically for links within any series admonition that point to the current page */
 .admonition-highlight-this-page a.reference.internal[href^="#"]:after {
-    content: " (in this article)";
-    font-style: italic;
-    font-weight: normal;
-    color: #777; /* Greyed out, independent of link visited state */
-    margin-left: 4px;
+  content: " (in this article)";
+  font-style: italic;
+  font-weight: normal;
+  color: #777; /* Greyed out, independent of link visited state */
+  margin-left: 4px;
 }

docs/MIR/mir-process-states.md

@@ -16,7 +16,13 @@ an MIR bug's current state.
 
 ```{mermaid}
 %% mermaid flowcharts documentation: https://mermaid.js.org/syntax/flowchart.html
-%%{ init: { "flowchart": { "curve": "monotoneY", "htmlLabels": true } } }%%
+%%{ init: { 'flowchart': {
+                'curve': 'monotoneY',
+                'htmlLabels': true },
+            'themeVariables': {
+                'fontSize': '1em',
+                'fontFamily': 'Ubuntu'} } }%%
+
 flowchart TD
     %% Styles
     classDef Invisible stroke-width:0,fill:#00000000
@@ -37,27 +43,27 @@ flowchart TD
     BugCreated>"Bug created"]
 
     %% Transitions
-    Start-->|"<div style='background:#8BC34A'><i>a)</i> create MIR bug</div>"| BugCreated
-    BugCreated-->|"<div style='background:#8BC34A'><i>b)</i> subscribe <code>~ubuntu-mir</code></div>"|ToReview
+    Start-->|"<div><i>a)</i> create MIR bug</div>"| BugCreated
+    BugCreated-->|"<div><i>b)</i> subscribe <code>~ubuntu-mir</code></div>"|ToReview
 
-    ToReview -->|"<div style='background:#4ECDC4'><i>c)</i> triaged by MIR team</div>"| AssignedToMirTeamMember
+    ToReview -->|"<div><i>c)</i> triaged by MIR team</div>"| AssignedToMirTeamMember
 
-    AssignedToMirTeamMember -->|"<div style='background:#4ECDC4'><i>d</i>) MIR team ACK</div>"| InProgress
-    AssignedToMirTeamMember -->|"<div style='background:#4ECDC4'><i>e</i>) MIR team ACK,<br>Security needed</div>"| AssignedToSecurityTeamMember
-    AssignedToMirTeamMember -->|"<div style='background:#4ECDC4'><i>f</i>) MIR team NACK</div>"| WontFix
-    AssignedToMirTeamMember -->|"<div style='background:#4ECDC4'><i>g</i>) needs questions/actions</div>"| Incomplete
+    AssignedToMirTeamMember -->|"<div><i>d</i>) MIR team ACK</div>"| InProgress
+    AssignedToMirTeamMember -->|"<div><i>e</i>) MIR team ACK,<br>Security needed</div>"| AssignedToSecurityTeamMember
+    AssignedToMirTeamMember -->|"<div><i>f</i>) MIR team NACK</div>"| WontFix
+    AssignedToMirTeamMember -->|"<div><i>g</i>) needs questions/actions</div>"| Incomplete
 
-    AssignedToSecurityTeamMember -->|"<div style='background:#DBB3B1'><i>h</i>) Security ACK</div>"| InProgress
-    AssignedToSecurityTeamMember -->|"<div style='background:#DBB3B1'><i>i</i>) Security NACK</div>"| WontFix
-    AssignedToSecurityTeamMember -->|"<div style='background:#DBB3B1'><i>j</i>) needs questions/actions</div>"| Incomplete
+    AssignedToSecurityTeamMember -->|"<div><i>h</i>) Security ACK</div>"| InProgress
+    AssignedToSecurityTeamMember -->|"<div><i>i</i>) Security NACK</div>"| WontFix
+    AssignedToSecurityTeamMember -->|"<div><i>j</i>) needs questions/actions</div>"| Incomplete
 
-    Incomplete -->|"<div style='background:#8BC34A'><i>k</i>) questions/actions resolved</div>"| ToReview
-    WontFix -->|"<div style='background:#8BC34A'><i>l</i>) situation changes</div>"| ToReview
-    InProgress -->|"<div style='background:#8BC34A'><i>m)</i> package(s) pulled into main</div>"| FixCommitted
+    Incomplete -->|"<div><i>k</i>) questions/actions resolved</div>"| ToReview
+    WontFix -->|"<div><i>l</i>) situation changes</div>"| ToReview
+    InProgress -->|"<div><i>m)</i> package(s) pulled into main</div>"| FixCommitted
 
     FixCommitted -->|"<i>n)</i> Archive Admin</br>promotes package(s)"| FixReleased
 
-    Incomplete -->|"<div style='background:#4ECDC4'><i>o)</i> no response</div>"| Invalid
+    Incomplete -->|"<div><i>o)</i> no response</div>"| Invalid
 ```
 
 | Index | State               | Assignee / Subscriber                   | State-Explanation |

docs/SRU/explanation/pipeline.rst

@@ -35,11 +35,11 @@ Overview of the SRU pipeline
 The following diagram illustrates this pipeline:
 
 .. mermaid::
-   :align: center
 
    %%{init: {'themeVariables': {
-                'fontSize': '20px',
+                'fontSize': '0.8em',
                 'fontFamily': 'Ubuntu'}}}%%
+
    flowchart TD
        prepare_package["Prepare the bug fix, and the SRU template"]
        unapproved["Upload the package to the unapproved queue"]

docs/how-ubuntu-is-made/concepts/package-archive.rst

@@ -10,11 +10,11 @@ On Ubuntu installations, the Ubuntu package archive is configured as the default
 The general flow is that the archive splits into :ref:`Ubuntu series <archive-series>`. Each series is split up into :ref:`pockets <archive-pockets>`, and then each pocket contains four :ref:`components <archive-components>`. This diagram shows a look through a single path:
 
 .. mermaid::
-   :align: center
 
    %%{init: {'themeVariables': {
-                'fontSize': '25px',
+                'fontSize': '1em',
                 'fontFamily': 'Ubuntu'}}}%%
+
     flowchart TD;
       A[Ubuntu package archive] --> B([Splits into Ubuntu **series**]);
 

docs/how-ubuntu-is-made/processes/lifecycle-1-report-triage.txt

@@ -1,17 +1,13 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '1.5em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart LR
-    File["<a href=https://documentation.ubuntu.com/project/contributors/qa-and-testing/report-a-bug/>File bug on Launchpad</a><br/>with reproduction steps<br/>and system details"] --> Triage
-    Triage{"<a href=https://documentation.ubuntu.com/project/contributors/bug-triage/>Triage</a>:<br/>enough information?<br/>right package?<br/>assignee?"}
-    PrepareFix(["<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/lifecycle-of-a-change/#preparing-and-testing-the-fix>Prepare change</a>"])
-    Triage -.-> |"needs more info"| File
+    File["<a href='/contributors/qa-and-testing/report-a-bug/'>File bug on Launchpad</a><br/>with reproduction steps and system details"] --> Triage
+    Triage{"<a href='/contributors/bug-triage/'>Triage</a>:<br/>enough information?<br/>right package?<br/>assignee?"}
+    PrepareFix(["<a href='#preparing-and-testing-the-change'>Prepare change</a>"])
+    Triage -.-> |"needs<br/>more info"| File
     Triage --> |"actionable"| PrepareFix
 
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class File ubuntuStyle
-
-    classDef gateStyle fill:#D0E8FF,stroke:#3366CC,stroke-width:2px
-    class Triage gateStyle
-
-    classDef terminalStyle fill:#E0E0E0,stroke:#666666,stroke-width:2px
-    class PrepareFix terminalStyle
 :::

docs/how-ubuntu-is-made/processes/lifecycle-2-prepare-test.txt

@@ -1,18 +1,17 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '1.8em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart LR
-    Fix["Prepare change:<br/><a href=https://documentation.ubuntu.com/project/contributors/bug-fix/fix-a-bug-in-a-package/>patch</a> · <a href=https://documentation.ubuntu.com/project/contributors/merging/>merge</a> · <a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/merges-and-syncs/>sync</a>"]
+    Fix["Prepare change:<br/><a href='/contributors/bug-fix/fix-a-bug-in-a-package/'>patch</a> · <a href='/contributors/merging/'>merge</a> · <a href='/how-ubuntu-is-made/processes/merges-and-syncs/'>sync</a>"]
     Fix --> Build
-    Build["<a href=https://documentation.ubuntu.com/project/contributors/bug-fix/build-packages-in-a-ppa/>PPA build</a> on Launchpad<br/>(all architectures)"]
+    Build["<a href='/contributors/bug-fix/build-packages-in-a-ppa/'>PPA build</a> on Launchpad<br/>(all architectures)"]
     Build -.-> |"build fails"| Fix
     Build --> |"build OK"| Test
-    Test["Run <a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/automatic-package-testing-autopkgtest/>autopkgtests</a><br/>against <a href=https://documentation.ubuntu.com/project/contributors/bug-fix/build-packages-in-a-ppa/>PPA</a> packages"]
+    Test["Run <a href='/how-ubuntu-is-made/processes/automatic-package-testing-autopkgtest/'>autopkgtests</a><br/>against <a href='/contributors/bug-fix/build-packages-in-a-ppa/'>PPA</a> packages"]
     Test -.-> |"test regressions"| Fix
-    ProposeChange(["<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/lifecycle-of-a-change/#proposing-and-reviewing>Propose change</a>"])
+    ProposeChange(["<a href='#proposing-and-reviewing'>Propose change</a>"])
     Test --> |"ready"| ProposeChange
 
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class Fix,Build,Test ubuntuStyle
-
-    classDef terminalStyle fill:#E0E0E0,stroke:#666666,stroke-width:2px
-    class ProposeChange terminalStyle
 :::

docs/how-ubuntu-is-made/processes/lifecycle-3-propose-review.txt

@@ -1,19 +1,15 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '1em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart LR
-    MP["<a href=https://documentation.ubuntu.com/project/contributors/patching/submit-a-merge-proposal/>Submit Merge Proposal</a><br/>on Launchpad"] --> Review
-    Review{"<a href=https://documentation.ubuntu.com/project/contributors/advanced/review-a-merge-proposal/>Code review</a>"}
+    MP["<a href='/contributors/patching/submit-a-merge-proposal/'>Submit Merge Proposal</a><br/>on Launchpad"] --> Review
+    Review{"<a href='/contributors/advanced/review-a-merge-proposal/'>Code review</a>"}
     Review -.-> |"changes requested"| Revise["Revise change</a>"]
     Revise --> Review
-    Upload(["<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/lifecycle-of-a-change/#sponsorship-and-upload>Upload</a>"])
+    Upload(["<a href='#sponsorship-and-uploads'>Upload</a>"])
     Review --> |"approved"| Upload
 
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class MP,Revise ubuntuStyle
-
-    classDef gateStyle fill:#D0E8FF,stroke:#3366CC,stroke-width:2px
-    class Review gateStyle
-
-    classDef terminalStyle fill:#E0E0E0,stroke:#666666,stroke-width:2px
-    class Upload terminalStyle
 :::
 

docs/how-ubuntu-is-made/processes/lifecycle-4-upload-sponsor.txt

@@ -1,18 +1,14 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '1.5em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart LR
-    Rights{"<a href=https://documentation.ubuntu.com/project/who-makes-ubuntu/developers/#path-to-upload-rights>Upload rights</a><br/>for this package?"}
-    Rights --> |"no: <a href=https://documentation.ubuntu.com/project/contributors/uploading/find-a-sponsor/>Find sponsor</a>"| Sponsor
-    Sponsor["sponsor <a href=https://documentation.ubuntu.com/project/contributors/advanced/review-a-merge-proposal/>re-reviews</a>"]
+    Rights{"<a href='/who-makes-ubuntu/developers/#path-to-upload-rights'>Upload rights</a><br/>for this package?"}
+    Rights --> |"no: <a href='/contributors/uploading/find-a-sponsor/'>Find sponsor</a>"| Sponsor
+    Sponsor["sponsor <a href='/contributors/advanced/review-a-merge-proposal/'>re-reviews</a>"]
     Sponsor --> |"sponsor approves"| Upload
     Rights --> |"yes"| Upload
-    Upload(["<a href=https://documentation.ubuntu.com/project/contributors/uploading/>Upload to Ubuntu Archive</a>"])
-
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class Sponsor ubuntuStyle
-
-    classDef gateStyle fill:#D0E8FF,stroke:#3366CC,stroke-width:2px
-    class Rights gateStyle
+    Upload(["<a href='/contributors/uploading/'>Upload to Ubuntu Archive</a>"])
 
-    classDef terminalStyle fill:#E0E0E0,stroke:#666666,stroke-width:2px
-    class Upload terminalStyle
 :::

docs/how-ubuntu-is-made/processes/lifecycle-5-proposed-migration.txt

@@ -1,30 +1,26 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '0.4em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart TD
     Build{Builds}
     Fix["Please fix & re-upload"]
-    Autopkg{"<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/automatic-package-testing-autopkgtest/>Autopkgtests</a>"}
-    InvestigateAPKGT["<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/proposed-migration/autopkgtest-regressions/>Investigate regressions</a>"]
-    ArchiveChecks{"<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration/>Archive consistency</a><br/>(<a href=https://ubuntu-archive-team.ubuntu.com/proposed-migration/update_excuses.html>Britney</a>)"}
+    Autopkg{"<a href='/how-ubuntu-is-made/processes/automatic-package-testing-autopkgtest/'>Autopkgtests</a>"}
+    InvestigateAPKGT["<a href='/how-ubuntu-is-made/processes/proposed-migration/autopkgtest-regressions/'>Investigate regressions</a>"]
+    ArchiveChecks{"<a href='/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration/'>Archive consistency</a><br/>(<a href='https://ubuntu-archive-team.ubuntu.com/proposed-migration/update_excuses.html'>Britney</a>)"}
     Done(["Migrates"])
-    
-    Build -.-> |"<a href=https://documentation.ubuntu.com/project/how-ubuntu-is-made/processes/proposed-migration/failure-to-build-from-source-ftbfs/>FTBFS"</a>| Fix
+
+    Build -.-> |"<a href='/how-ubuntu-is-made/processes/proposed-migration/failure-to-build-from-source-ftbfs/'>FTBFS"</a>| Fix
     Build --> |"all builds OK"| Autopkg
-    
+
     Autopkg -.-> |"regressions"| InvestigateAPKGT
     Autopkg --> |"all pass"| ArchiveChecks
-    
+
     InvestigateAPKGT -.-> |"Real problem"| Fix
     InvestigateAPKGT --> |"Transient issues, now resolved"| ArchiveChecks
 
     ArchiveChecks -.-> |"blocked by dependencies"| Fix
     ArchiveChecks --> |"all checks OK"| Done
 
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class Fix,InvestigateAPKGT ubuntuStyle
-
-    classDef gateStyle fill:#D0E8FF,stroke:#3366CC,stroke-width:2px
-    class Build,Autopkg,ArchiveChecks gateStyle
-
-    classDef terminalStyle fill:#E0E0E0,stroke:#666666,stroke-width:2px
-    class Done terminalStyle
 :::

docs/how-ubuntu-is-made/processes/lifecycle-of-a-change.txt

@@ -1,4 +1,8 @@
 :::{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '2em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart LR
     BugReport["<a href='#lc-bug-report-and-triage'>Bug Report<br/>&amp; Triage</a>"]
     PrepareTest["<a href='#lc-prepare-fix'>Prepare<br/>&amp; Test</a>"]
@@ -14,7 +18,5 @@ flowchart LR
     Upload -.-> |"active release"| SRU
     SRU --> Migration
 
-    classDef ubuntuStyle fill:#FFDAB9,stroke:#E95420,stroke-width:2px
-    class BugReport,PrepareTest,Review,Migration,Upload,SRU ubuntuStyle
 :::
 

docs/how-ubuntu-is-made/processes/proposed-migration/failure-to-build-from-source-ftbfs.md

@@ -146,6 +146,10 @@ Sometimes a package builds successfully locally (and even in a PPA), but fails i
 [pkgbinarymangler](https://launchpad.net/ubuntu/+source/pkgbinarymangler) is one of those upload-only steps. It is disabled for all PPA builds (except for `OEM PPA`) and also absent from most local build environments unless `pkgbinarymangler` is explicitly installed.
 
 ```{mermaid}
+   %%{init: {'themeVariables': {
+                'fontSize': '1em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart TD
   A["dh_builddeb<br>(manages lockfile)"] --> B["Lockfile<br>(queue)"]
   B -->|"wait(head==package1)"| C["dpkg-deb.pkgbinarymangler<br>Binary Package 1"]
@@ -197,4 +201,4 @@ To reproduce this issue locally, install `pkgbinarymangler` in your build enviro
 
 ```none
 $ sudo apt install -y pkgbinarymangler
-```
+```

docs/who-makes-ubuntu/councils/dmb-manage-packagesets.md

@@ -33,6 +33,10 @@ Think of it as a relation between Launchpad personas and a list of packages.
 
 ```{mermaid}
 %% mermaid flowcharts documentation: https://mermaid.js.org/syntax/flowchart.html
+   %%{init: {'themeVariables': {
+                'fontSize': '0.6em',
+                'fontFamily': 'Ubuntu'}}}%%
+
 flowchart TD
     %% Entities
     Developers["Developer"]