draw.io?

.github/ISSUE_TEMPLATE/content_suggestion.md

@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 **Which part of the roadmap?**
-File/section (e.g. `English/Tooling.md`) or the roadmap graph/Miro board.
+File/section (e.g. `English/Tooling.md`) or the roadmap diagram (`Graph/roadmap.drawio.svg`).
 
 **What should be changed and why?**
 Describe the correction or improvement. If something is factually outdated

.lycheeignore

@@ -16,3 +16,7 @@ https://(en|ru|zh)\.cppreference\.com/.*
 https://isocpp\.org/.*
 # Intel blocks automated clients (bots)
 https://www\.intel\.com/.*
+# Our own /goto/ redirect pages: a PR that adds a new one always 404s until
+# it is merged and GitHub Pages redeploys, so checking them pre-merge is a
+# guaranteed false positive (chicken-and-egg).
+https://salmer\.github\.io/CppDeveloperRoadmap/goto/.*

CONTRIBUTING.md

@@ -8,6 +8,10 @@ This project maintains parity across three languages: English (`English/`), Russ
 **Any content change (e.g., adding a book, updating a tool, fixing a description) MUST be mirrored across all three languages.** 
 If you are unable to translate the content into all languages, please create an issue or note it in your Pull Request so someone can help translate it.
 
+## Editing the Roadmap
+
+The roadmap is one `roadmap.drawio.svg` file per language (`English/Graph/`, `Russian/Graph/`, `Chinese/Graph/`) — an SVG image with the editable draw.io diagram embedded inside it. Edit it only with a draw.io editor (sketch.diagrams.net — the whiteboard-style UI with GitHub integration, the draw.io desktop app, or the VS Code extension) and submit the change as a normal pull request; see the per-language `Graph/README.md` for step-by-step instructions. **Never edit the SVG text by hand** — that can strip the embedded source and make the file uneditable. The language sync rule applies to the roadmap too: structural changes should be mirrored in all three language files.
+
 ## Local Jekyll Preview
 
 To preview the site locally using GitHub Pages:
@@ -29,6 +33,6 @@ We use `lychee` to ensure all links are valid.
 Before opening a PR, please run `lychee` locally to verify links. Run the following command (requires `lychee` to be installed):
 
 ```bash
-lychee --no-progress --accept "200..=204,429" --max-retries 2 --timeout 45 --exclude-path IMPROVEMENTS.md --exclude-path TODO.md "**/*.md"
+lychee --no-progress --accept "200..=204,429" --max-retries 2 --timeout 45 "**/*.md"
 ```
 This command must exit with code 0. Run this after ANY link change.

Chinese/Graph/README.md

@@ -1,9 +1,19 @@
-# 如何查看和修改 GraphML 格式的路线图
+# 如何查看和编辑路线图
 
-GraphML 是一种基于 XML 的图形文件格式。许多应用程序都支持它进行查看。
+路线图存储在 [roadmap.drawio.svg](roadmap.drawio.svg) 文件中——这是一个普通的 SVG 图像，其中嵌入了可编辑的 [draw.io](https://www.drawio.com) 图表。同一个文件既是您看到的图片，也是您编辑的源文件，因此无需导出或保持同步：每个被接受的 pull request 都会立即更新发布的路线图。
 
-例如，您可以使用[yEd](https://www.yworks.com/products/yed)来查看 graphML 文件并根据需要进行修改。
+## 查看
 
-*最后与 Miro 同步：2023-09-19*
+- 在网站上：[salmer.github.io/CppDeveloperRoadmap/goto/svg/?l=zh](https://salmer.github.io/CppDeveloperRoadmap/goto/svg/?l=zh)
+- 在 GitHub 上：打开 [roadmap.drawio.svg](roadmap.drawio.svg)——它会以图像形式呈现。
 
-![示例](../../assets/example.png)
+## 编辑
+
+1. Fork 本仓库。
+2. 在 draw.io 编辑器中打开图表：
+   - **网页版：** 访问 [sketch.diagrams.net](https://sketch.diagrams.net)（draw.io 的白板风格界面），从 *GitHub* 打开文件，授权后在您的 fork 中选择 `Chinese/Graph/roadmap.drawio.svg`。保存时会直接提交到您的 fork。
+   - **VS Code：** 安装 [Draw.io Integration 扩展](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio)后打开该文件（也可以通过 github.dev 在浏览器中使用——在您的 fork 页面按 `.` 键）。
+   - **桌面版：** [draw.io 桌面应用](https://www.drawio.com)。
+3. 创建包含您更改的 pull request。
+
+> :warning: 请勿在 draw.io 之外手动编辑 SVG 文本——这可能会删除嵌入的图表源，使文件无法再编辑。文件开头的注释也有同样的警告。

Chinese/README.md

@@ -26,11 +26,11 @@ C++ 仍然是 [2025 年](https://survey.stackoverflow.co/2025/technology#most-po
 
 路线图提供以下格式：
 
+* :arrow_forward: [draw.io（源文件，可编辑）](https://salmer.github.io/CppDeveloperRoadmap/goto/drawio/?l=zh)
 * :arrow_forward: [Miro](https://salmer.github.io/CppDeveloperRoadmap/goto/miro/?l=zh)
 * :arrow_forward: [SVG](https://salmer.github.io/CppDeveloperRoadmap/goto/svg/?l=zh)
-* :arrow_forward: [GraphML（源文件）](https://salmer.github.io/CppDeveloperRoadmap/goto/graphml/?l=zh)
 
-有关如何查看和编辑 graphML 文件的说明，请参见[此处](Graph/README.md)。
+每种语言的路线图都是一个 `roadmap.drawio.svg` 文件——您看到的图像和可编辑的 [draw.io](https://www.drawio.com) 源文件合二为一。有关如何查看和编辑的说明，请参见[此处](Graph/README.md)。
 
 ## :key: 许可证和条件
 
@@ -45,8 +45,8 @@ C++ 仍然是 [2025 年](https://survey.stackoverflow.co/2025/technology#most-po
 
 您可以通过 Github 中的以下渠道之一联系我们：
 
-* 如果对存储库内容进行任何建议或修改 - 在[Pull Requests](https://github.com/salmer/CppDeveloperRoadmap/pulls) 中创建新 PR
-* 如果对 **Miro 路线图** 有任何建议或修改 - 在[Issues](https://github.com/salmer/CppDeveloperRoadmap/issues)中提交新问题。(不幸的是，Miro 框架没有历史跟踪器并且无法访问路线图。所有更改都是在审核和批准后手动添加。)
+* 如果对**内容或路线图**有任何建议或修改 - 在[Pull Requests](https://github.com/salmer/CppDeveloperRoadmap/pulls) 中创建新 PR（路线图可以像普通文件一样编辑——参见[说明](Graph/README.md)）
+* 如果有**不涉及具体修改**的问题或建议 - 在[Issues](https://github.com/salmer/CppDeveloperRoadmap/issues)中提交新问题
 
 # :telephone: 联系方式
 

English/Graph/README.md

@@ -1,9 +1,19 @@
-# How to view and modify the roadmap in graphML format
+# How to view and edit the roadmap
 
-GraphML is an XML-based file format for graphs. It is supported by many applications for viewing it.
+The roadmap is stored as [roadmap.drawio.svg](roadmap.drawio.svg) — a regular SVG image with the editable [draw.io](https://www.drawio.com) diagram embedded inside it. The same file is both the picture you see and the source you edit, so there is nothing to export or keep in sync: every accepted pull request updates the published roadmap immediately.
 
-For example, you can use [yEd](https://www.yworks.com/products/yed) to view graphML file and modify it as you want.
+## Viewing
 
-*Last synced with Miro: 2023-02-17*
+- On the site: [salmer.github.io/CppDeveloperRoadmap/goto/svg/?l=en](https://salmer.github.io/CppDeveloperRoadmap/goto/svg/?l=en)
+- On GitHub: open [roadmap.drawio.svg](roadmap.drawio.svg) — it renders as an image.
 
-![Roadmap example](../../assets/example.png)
+## Editing
+
+1. Fork the repository.
+2. Open the diagram in one of the draw.io editors:
+   - **Web:** go to [sketch.diagrams.net](https://sketch.diagrams.net) (the whiteboard-style UI of draw.io), open the file from *GitHub*, authorize, and select `English/Graph/roadmap.drawio.svg` in your fork. Saving commits directly to your fork.
+   - **VS Code:** install the [Draw.io Integration extension](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) and open the file (this also works in the browser via github.dev — press `.` on your fork).
+   - **Desktop:** the [draw.io desktop app](https://www.drawio.com).
+3. Open a pull request with your change.
+
+> :warning: Do not edit the SVG text by hand outside draw.io — that can strip the embedded diagram source and make the file uneditable. The file starts with a comment saying the same.