Fix mermaid syntax

[Eng-YasminKotb]

Summary

This diagram fix syntax error compatiblity with GitHub's rendering engine (Mermaid v9.4.3).

jabref-contrib-policy:4.2:reviewed​:ok

Steps to test
To test this change, open the developer documentation file where the package structure is explained.

Related issues and pull requests
Closes #16760

AI usage
Claude (Claude Sonnet 5)

---

Checklist

• I own the copyright of the code submitted and I license it under the MIT license
• [/] If AI tools were used, I disclosed them in the "AI usage" section and reviewed, understood, and take full ownership of all AI-generated code
• [/] I manually tested my changes in running JabRef (always required)
• [/] I added JUnit tests for changes (if applicable)
• I added screenshots in the PR description (if change is visible to the user)
• [/] I added one sentence (max 20 words) to CHANGELOG.md describing the change from the user's point of view (if the change is visible to the user)
• [/] I checked the user documentation for up to dateness and submitted a pull request to our user documentation repository

[qodo-free-for-open-source-projects]

PR Summary by Qodo

Fix GitHub-compatible Mermaid package diagram syntax

🐞 Bug fix 📝 Documentation 🕐 Less than 5 minutes

AI Description

• Fixes package diagram rendering with GitHub's Mermaid 9.4.3 engine.
• Preserves shared-layer grouping through transparent links and compatible declaration ordering.

Diagram

graph TD
    DOC["Architecture docs"] -->|parsed by| ENGINE["Mermaid 9.4.3"] -->|renders| VIEW["GitHub preview"]

Loading

High-Level Assessment

The current approach is appropriate because it keeps the diagram editable while adapting its layout syntax to GitHub's fixed Mermaid version. Replacing it with a static image would reduce maintainability, while removing the shared grouping would lose architectural context.

Files changed (1) +8 / -13

Other (1) +8 / -13

architecture-and-components.mdMake the package diagram compatible with GitHub Mermaid +8/-13

Make the package diagram compatible with GitHub Mermaid

• Reorders the shared-layer subgraph and replaces the shared placeholder connection with transparent links from the model node. Removes class annotations that are unnecessary for the revised GitHub-compatible rendering.

docs/architecture-and-components.md

[qodo-free-for-open-source-projects]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can switch off images and animations for a plain-text comment

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗