Skip to content

Remove redundant Mermaid collection diagram from Docusaurus landing page #1239

@WilliamBerryiii

Description

@WilliamBerryiii

Summary

The Docusaurus landing page (docs/docusaurus/src/pages/index.tsx) includes a Mermaid graph TD diagram at the bottom that visualizes the collection hierarchy as a flat star topology from hve-core-all to 9 child collections. This diagram is redundant given the collection cards section directly above it, which already presents the same information with richer detail (descriptions, maturity badges, artifact counts).

Problem

  • The diagram is a flat star topology with no hierarchy, dependencies, or data flow — it restates what the cards already show.
  • The diagram data is stale (e.g., artifact counts don't match current values).
  • 3 collections present in collections/ (gitlab, jira, rai-planning) are missing from the diagram.
  • The diagram previously had a parse error (multiple node definitions on the same line) and rendering issues (SVG too small), both patched but symptoms of low maintainability.

Proposed Changes

  1. Remove the collectionDiagram template literal from index.tsx
  2. Remove the <Mermaid> component and its diagramContainer wrapper
  3. Remove the import Mermaid from '@theme/Mermaid' import
  4. Clean up .diagramContainer CSS rules from styles.module.css

Acceptance Criteria

  • Landing page renders without the Mermaid diagram
  • No unused imports or CSS rules remain
  • Docusaurus build succeeds

Metadata

Metadata

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions