Skip to content

docs: restructure i18n folders and add 'Add New SoC' guide - #4

Merged
potterwhite merged 1 commit into
mainfrom
br_v0.5.2
Dec 30, 2025
Merged

potterwhite merged 1 commit into
mainfrom
br_v0.5.2

Conversation

@potterwhite

Copy link
Copy Markdown
Owner

Description:

📝 Summary

This PR restructures the documentation directory to support proper internalization (i18n) by separating English and Chinese content. It also introduces two major documentation guides requested by the community and updates the root README.md to reflect these changes.

🛠️ Changes

  • Directory Structure:
    • docs/ -> docs/en/ & docs/zh-cn/
  • New Documentation:
    • ADD_NEW_SOC.md: A step-by-step tutorial on adding new cross-compilation targets (SoCs) via the .env and CMakePresets.json system.
    • BUILD_SYSTEM.md: A technical deep dive into the project's Modern CMake architecture, including Mermaid diagrams for the build lifecycle and module topology.
  • Refactor:
    • Updated relative links in README.md.
    • Added new Mermaid diagrams to the main README for better architectural visibility.

🔍 Test Plan

  • Verify README.md renders correctly on GitHub.
  • Check all relative links (English and Chinese) point to the correct new locations.
  • Verify Mermaid diagrams render correctly.

🔗 Linked Issues

Closes # (Issue ID if applicable)

- Refactor `docs/` directory structure: separate content into `docs/en/` and `docs/zh-cn/` for better localization management.
- Add comprehensive guide "How to Add Support for a New SoC" (`ADD_NEW_SOC`) in both English and Chinese.
  - Covers Toolchain creation, Environment setup (.env), External Dependencies (Sherpa-Onnx/RKNN), and CMakePresets registration.
- Add deep dive documentation "ArcForge Build System Explained" (`BUILD_SYSTEM`) visualizing the CMake lifecycle and architecture.
- Update `README.md` and `docs/zh-cn/README_ZH_CN.md`:
  - Fix relative links to match the new directory structure.
  - Add Mermaid architecture diagrams and updated "Quick Start" sections.
  - Add "Supporting New Platforms" section.

Closes: #4
@potterwhite
potterwhite merged commit b9a8f88 into main Dec 30, 2025
1 check passed
@potterwhite
potterwhite deleted the br_v0.5.2 branch December 30, 2025 08:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant