Skip to content

docs: consolidate 10 docs per language into 3 + bilingual index#11

Merged
zevorn merged 2 commits intomainfrom
docs/consolidate-3-docs
Apr 29, 2026
Merged

docs: consolidate 10 docs per language into 3 + bilingual index#11
zevorn merged 2 commits intomainfrom
docs/consolidate-3-docs

Conversation

@zevorn
Copy link
Copy Markdown
Owner

@zevorn zevorn commented Apr 29, 2026

Summary

  • Reorganize docs/ from 10 fragmented docs per language into 3 consolidated docs following triton-cpu/docs/riscv64 structure
  • getting-started.md (532 lines): build, launch, HIP test, GPU driver init, standalone appendix
  • architecture.md (1003 lines): system design, memory sharing, GART, DMA, xGMI, design history
  • reference.md (564 lines): parameters, pitfalls, debugging, PTE layout, file reference
  • Create docs/README.md bilingual index with Quick Links table
  • Update README.md and README.zh.md Documentation sections
  • Delete all 20 old doc files (10 per language)
  • en/zh have identical section structure and line counts

Test plan

  • Verify docs/en/ and docs/zh/ each contain exactly 3 files
  • Verify docs/README.md has bilingual Quick Links table
  • Verify all internal markdown links resolve (no broken links)
  • Verify en/zh cross-language links on first line of each doc
  • Spot-check content coverage: GART, modprobe params, debugging pitfalls all present

Reorganize docs/ following triton-cpu/docs/riscv64 structure:
- getting-started.md: build, launch, HIP test, GPU driver init
- architecture.md: system design, memory sharing, GART, xGMI
- reference.md: parameters, pitfalls, debugging, PTE layout

Create docs/README.md bilingual index with Quick Links table.
Update README.md and README.zh.md to reference new structure.
Delete all 20 old doc files (10 per language).

Signed-off-by: Chao Liu <chao.liu.zevorn@gmail.com>
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 33130540ae

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/en/getting-started.md Outdated
- Fix manual disk-image build path: cd gem5-resources/ (not ../gem5-resources/)
- Align component diagram box borders in architecture.md (en+zh)
- Replace getting-started overview diagram with README's proven layout

Signed-off-by: Chao Liu <chao.liu.zevorn@gmail.com>
@zevorn zevorn merged commit 8595cfe into main Apr 29, 2026
5 checks passed
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