diff --git a/docs/architecture.html b/docs/architecture.html
index 5e27d31..3def31a 100644
--- a/docs/architecture.html
+++ b/docs/architecture.html
@@ -16,13 +16,13 @@
         <div class="diagram">
           <pre class="mermaid">
 flowchart LR
-  Browser[Client browser] -->|HTTP/HTTPS| Next[Next.js App Router<br/>SSR/ISR + API routes]
+  Browser[Client browser] -->|HTTP/HTTPS| Next[Next.js App Router / SSR-ISR + API routes]
   Next --> Prisma[Prisma ORM]
   Prisma --> Postgres[(PostgreSQL)]
-  Next --> Mailer[SMTP mailer<br/>(smtp.sohva.org + DKIM)]
-  Next --> Storage[Image URLs (remote/bucket)]
-  Admin[Admin / Moderators] --> Next
-  Next --> Auth[Auth module<br/>JWT session cookie]
+  Next --> Mailer[SMTP mailer (smtp.sohva.org + DKIM)]
+  Next --> Storage[Image URLs (remote bucket)]
+  Admin[Admin and Moderators] --> Next
+  Next --> Auth[Auth module / JWT session cookie]
           </pre>
         </div>
         <div class="callout">Edit the Mermaid block above to evolve the architecture.</div>
diff --git a/docs/build.html b/docs/build.html
index 1e47db5..8897617 100644
--- a/docs/build.html
+++ b/docs/build.html
@@ -19,13 +19,13 @@ flowchart LR
   Dev[Developer] -->|npm run lint| Lint
   Dev --> BuildScript[./deploy/build.sh]
   Lint --> BuildScript
-  BuildScript --> Docker[Docker buildx<br/>multi-stage]
-  Docker --> Image[registry.halla-aho.net<br/>thalla/lomavuokraus-web]
+  BuildScript --> Docker[Docker buildx multi-stage]
+  Docker --> Image[registry.halla-aho.net/thalla/lomavuokraus-web]
   Image --> Push[./deploy/push.sh]
   Push --> DeployStg[./deploy/deploy-staging.sh]
   Push --> DeployProd[./deploy/deploy-prod.sh]
-  DeployStg --> K8sStg[kubectl apply<br/>rollout (staging)]
-  DeployProd --> K8sProd[kubectl apply<br/>rollout (prod)]
+  DeployStg --> K8sStg[kubectl apply + rollout (staging)]
+  DeployProd --> K8sProd[kubectl apply + rollout (prod)]
           </pre>
         </div>
         <div class="callout">Edit the Mermaid block to reflect pipeline changes; no external tooling required.</div>
diff --git a/docs/infra.html b/docs/infra.html
index a65026c..f466a97 100644
--- a/docs/infra.html
+++ b/docs/infra.html
@@ -16,10 +16,10 @@
         <div class="diagram">
           <pre class="mermaid">
 graph LR
-  User[User Browser] -->|HTTPS| Traefik[Traefik Ingress<br/>IngressClass traefik]
-  Traefik -->|Host: lomavuokraus.fi<br/>staging.lomavuokraus.fi| Service[Service<br/>port 80 to 3000]
+  User[User Browser] -->|HTTPS| Traefik[Traefik Ingress (IngressClass traefik)]
+  Traefik -->|Host: lomavuokraus.fi / staging.lomavuokraus.fi| Service[Service port 80 to 3000]
   Service --> Pod[Next.js Pods (2)]
-  Pod --> DB[(PostgreSQL<br/>46.62.203.202)]
+  Pod --> DB[(PostgreSQL 46.62.203.202)]
   Pod --> SMTP[smtp.sohva.org]
   subgraph Cluster [k3s Cluster hel1 cx22 157.180.66.64]
     Traefik
@@ -31,7 +31,7 @@ graph LR
   end
   CertMgr -->|TLS| Traefik
   Registry[registry.halla-aho.net/thalla/lomavuokraus-web] -->|pull| Pod
-  DNS[lomavuokraus.fi<br/>staging.lomavuokraus.fi<br/>api.lomavuokraus.fi] --> Traefik
+  DNS[lomavuokraus.fi / staging.lomavuokraus.fi / api.lomavuokraus.fi] --> Traefik
           </pre>
         </div>
         <div class="callout">Mermaid renders directly in the browser; edit the graph in this file to update.</div>