Serge Huber created UNOMI-969:
---------------------------------
Summary: Manual PlantUML diagrams lack consistent Unomi brand
styling
Key: UNOMI-969
URL: https://issues.apache.org/jira/browse/UNOMI-969
Project: Apache Unomi
Issue Type: Improvement
Components: unomi(-core)
Affects Versions: unomi-3.1.0
Reporter: Serge Huber
Assignee: Serge Huber
Fix For: unomi-3.1.0
h2. Summary
Diagrams in the Apache Unomi manual still render with ad-hoc default colours
(generic blues and greens) that do not match the Unomi website and manual
brand. Readers see a mix of styles instead of one coherent visual language
across architecture, conditions, security, and upgrade chapters.
h2. What is going wrong today
* Many PlantUML blocks set their own skin colours (LightBlue, LightGreen, and
similar) instead of sharing one project theme.
* Diagram look-and-feel does not follow the Unomi site / manual design tokens
(primary purple and related accents).
* Adding or editing a diagram requires copying colour rules by hand, so
inconsistency grows over time.
* The manual already has a strong HTML/PDF brand; the diagrams are the visible
outlier.
h2. Impact
* Harder for newcomers and partners to recognise Unomi documentation as one
product surface.
* Extra maintenance cost whenever diagrams are added or updated.
* Weaker first impression next to the branded manual chrome delivered in recent
3.x docs work.
h2. Who is affected
* Readers of the published manual (HTML and PDF)
* Contributors who maintain or add PlantUML diagrams
* Release / docs owners checking visual consistency before a release
h2. What good would look like
* All manual PlantUML diagrams share one Unomi brand palette aligned with the
site / manual CSS tokens.
* New diagrams pick up the theme automatically (no per-diagram LightBlue /
LightGreen overrides).
* Role colours (core, persistence, security, and similar) remain readable via
shared stereotypes or equivalent theme rules.
* Building the manual still produces diagrams correctly for HTML and PDF.
h2. Related
* [UNOMI-882] — Enhanced Technical Documentation with Integrated Diagrams
* Local branch {{manual-plantuml-brand-theme}} (implementation ready for PR
once this issue exists)
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
