Skip to content

Give the mermaid architecture diagrams white subgraph backgrounds - #115

Merged
paolosalvatori merged 2 commits into
mainfrom
mermaid-white-background
Aug 11, 2026
Merged

Give the mermaid architecture diagrams white subgraph backgrounds#115
paolosalvatori merged 2 commits into
mainfrom
mermaid-white-background

Conversation

@paolosalvatori

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #114. Mermaid's default theme paints subgraph (cluster) backgrounds pale yellow. This adds style overrides to every subgraph in the three diagrams (eventhubs, eventhubs-eventgrid, servicebus/java): white fill, gray border, dark title text — matching the white rounded containers of the Visio-made architecture images used by the other samples.

Verified by rendering all three diagrams with mermaid-cli; explicit label text color keeps the titles readable in GitHub dark mode too.

🤖 Generated with Claude Code

Mermaid's default theme fills subgraphs pale yellow. Style every subgraph
in the eventhubs, eventhubs-eventgrid and servicebus diagrams with a white
fill, gray border and dark title text, matching the white rounded
containers of the Visio-made architecture images.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@paolosalvatori
paolosalvatori requested a review from a team as a code owner August 11, 2026 12:43
Copilot AI lite review requested due to automatic review settings August 11, 2026 12:43

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Mermaid architecture diagrams in the Event Hubs and Service Bus samples to match the visual style of the other (Visio-based) architecture images by forcing subgraph/cluster containers to render with white backgrounds, gray borders, and dark title text (including improved readability in GitHub dark mode).

Changes:

  • Add style overrides for subgraph containers in the Event Hubs Python architecture diagram.
  • Add style overrides for subgraph containers in the Event Hubs + Event Grid Python architecture diagram.
  • Add style overrides for subgraph containers in the Service Bus Java architecture diagram.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
samples/servicebus/java/README.md Styles the host and sbns subgraph containers to use white fill/gray border/dark text.
samples/eventhubs/python/README.md Styles the producers, ehns, funcapp, and storage subgraph containers for consistent white/gray container rendering.
samples/eventhubs-eventgrid/python/README.md Styles the ehns, storage, eventgrid, and funcapp subgraph containers for consistent container rendering and dark-mode readability.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

The 7-step pipeline rendered as a ~6:1 wide ribbon in left-to-right
orientation, making labels unreadably small at page width. Top-to-bottom
gives a near-square aspect with full-size text, matching the vertical
flow of the original ASCII drawing.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@paolosalvatori
paolosalvatori merged commit c9dcb03 into main Aug 11, 2026
3 checks passed
paolosalvatori added a commit that referenced this pull request Aug 11, 2026
…ds (#116)

* Make the url-shortener diagram vertical with white subgraph backgrounds

The left-to-right layout rendered as a wide ribbon with unreadably small
labels at page width, and the subgraphs used mermaid's default pale-yellow
fill. Switch to top-to-bottom (near-square aspect, full-size text) and
style the subgraphs white with gray borders, matching the treatment the
other samples' diagrams received in #115.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Untangle the url-shortener diagram's edge routing

The Storage Account subgraph forced links/qrjobs/qrcodes to sit adjacent,
so every edge into them shared one corridor and the arcs overlapped and
merged. Dissolve that cluster into individually placed nodes labeled
"(Storage Account)", group each user journey's edges together, add
node/rank spacing, and route the storage metrics edge from the links
table. Every edge now runs separately with its label on it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants