docs: improve metamodel reference

[AlexanderLanin]

Review 1: is it readable etc? see rendered page

Review 2: should we make the code more readable via OOP?

[github-actions]

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //src:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.6.0) and connecting to it...
INFO: Invocation ID: b05d0505-0f02-4037-a0e9-d044251dbfa7
Computing main repo mapping: 
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: src
WARNING: Target pattern parsing failed.
ERROR: Skipping '//src:license-check': no such target '//src:license-check': target 'license-check' not declared in package 'src' defined by /home/runner/work/docs-as-code/docs-as-code/src/BUILD
ERROR: no such target '//src:license-check': target 'license-check' not declared in package 'src' defined by /home/runner/work/docs-as-code/docs-as-code/src/BUILD
INFO: Elapsed time: 6.197s
INFO: 0 processes.
ERROR: Build did NOT complete successfully
ERROR: Build failed. Not running target

[github-actions]

Documentation preview for this pull request is available at:
pr-748: https://eclipse-score.github.io/docs-as-code/pr-748/

[a-zw]

To be honest, I hate this. It is too much waste. Personally, I will rather look at the YAML file again.

[MaximilianSoerenPollak]

From my side this is okay.
Though it seems to get more and more unmaintainable with updates so we should ensure that it's not such a mess in the end that we don't understand it anymore.

I would also wait for @a-zw to be alright with this being merged as he had comments regarding it.

all findings addressed

[Copilot]

Pull request overview

Refactors and expands the generated metamodel reference.

Changes:

• Introduces typed models and dedicated Mermaid/RST renderers.
• Adds per-type diagrams and collapsible option/link tables.
• Updates the generated-documentation reference link.

Reviewed changes

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

File	Description
generate_metamodel_rst.py	Refactors and expands reference generation.
BUILD	Reformats generated outputs.
generated_docs.rst	Updates the metamodel reference link.

---

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

[RolandJentschETAS]

Some texts are cutted

[AlexanderLanin]

Fixed in the pending worktree changes: Mermaid SVGs no longer use fixed 167/333px heights; they use automatic height so rendered text is not clipped. The changes remain intentionally uncommitted.

[AlexanderLanin]

Korrektur zum vorherigen Kommentar: Die automatische SVG-Höhe wurde auf Wunsch zurückgenommen und die ursprüngliche feste Höhenlogik (167/333 px bzw. Standardhöhe) wiederhergestellt. Der Screenshot-Befund bleibt damit bewusst offen.

[AlexanderLanin]

Some texts are cutted

cannot reproduce. this basically shows that the browser is not supported by mermaid. we can try updating mermaid.