docs: improve library presentation in README and website by tbouffard · Pull Request #1006 · maxGraph/maxGraph · GitHub
Skip to content

docs: improve library presentation in README and website#1006

Merged
tbouffard merged 8 commits into
mainfrom
docs/improve_lib_presentation
Feb 19, 2026
Merged

docs: improve library presentation in README and website#1006
tbouffard merged 8 commits into
mainfrom
docs/improve_lib_presentation

Conversation

@tbouffard

@tbouffard tbouffard commented Feb 18, 2026

Copy link
Copy Markdown
Member
  • Rewrite intro paragraph to be clearer and developer-focused
  • Replace mxGraph successor bullet list with a concise paragraph
  • Add short feature list (10 items with emojis) to README
  • Add full feature list with categories to the website intro page

Notes

Initially, this PR includes a page that compares maxGraph with various diagramming libraries, including JointJS, GoJS, React Flow, Cytoscape.js, X6, mxGraph, and diagram-js.

It has been removed as it did not provide enough valuable information, but it could serve as a starting point if someone wants to create such a page.

See https://github.com/maxGraph/maxGraph/blob/8d434b253958871447a5753cc95cf8fb3fb20e73/packages/website/docs/comparison.md

Summary by CodeRabbit

  • Documentation
    • Revised project documentation with enhanced feature descriptions.
    • Added comprehensive Features sections detailing core capabilities, interactive editing, automatic layouts, data serialization, and developer experience.
    • Modernized documentation narrative emphasizing modern architecture, framework-agnostic design, and diagram application building capabilities.

- Rewrite intro paragraph to be clearer and developer-focused
- Replace mxGraph successor bullet list with a concise paragraph
- Add short feature list (10 items with emojis) to README
- Add full feature list with categories to the website intro page
- Add comparison page with detailed analysis of JointJS, GoJS,
  React Flow, Cytoscape.js, X6, mxGraph, and diagram-js
@tbouffard tbouffard added the documentation Improvements or additions to documentation label Feb 18, 2026
@coderabbitai

coderabbitai Bot commented Feb 18, 2026

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 5

🧹 Nitpick comments (1)
README.md (1)

7-7: Stale TODO comment — both target files have already been updated in this PR.

[//]: # (TODO apply to core/README.md and website/docs/intro.md) was presumably written before the edits to packages/core/README.md and packages/website/docs/intro.md were done. Safe to remove.

♻️ Proposed removal
-[//]: # (TODO apply to core/README.md and website/docs/intro.md)
 <!-- copied into packages/core/README.md and packages/website/docs/intro.md -->

Comment thread packages/website/docs/comparison.md Outdated
Comment thread packages/website/docs/comparison.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
@sonarqubecloud

Copy link
Copy Markdown

@tbouffard tbouffard merged commit b30ae50 into main Feb 19, 2026
8 checks passed
@tbouffard tbouffard deleted the docs/improve_lib_presentation branch February 19, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant