Skip to content

[refactor] drop doc submodules, link community docs to official sites - #136

Merged
hipudding merged 2 commits into
Ascend:mainfrom
zheliuyu:main
Aug 13, 2026
Merged

[refactor] drop doc submodules, link community docs to official sites#136
hipudding merged 2 commits into
Ascend:mainfrom
zheliuyu:main

Conversation

@zheliuyu

Copy link
Copy Markdown
Collaborator

Summary

Stop embedding community Ascend/NPU docs via git submodules and local copy. Projects with official doc sites now link out from homepage cards and lightweight sidebar placeholder pages.

Affected: verl, LLaMA-Factory, ms-swift, VeOmni, vLLM-Ascend, Triton-Ascend, DeepSpeed, and ONNX Runtime quick start.

Changes

  • Remove 7 git submodules and copy-docs / sync-onnxruntime-doc build steps
  • Simplify build to fetch-config → sphinx-build; drop submodules: true in CI
  • Replace portal pages with short sources/<project>/index.rst placeholders
  • Remove independent sidebar logic (layout.html, independent_communities, related CSS/JS)

Locally maintained docs (accelerate, trl, pytorch, etc.) are unchanged.

Motivation

  • Lower CI failure rate and memory usage (no duplicate _repos + _generated content)
  • Reduce maintenance of submodule versions and per-project copy rules
  • Users get up-to-date docs directly from upstream

Test plan

  • make html succeeds locally

@ascend-robot

Copy link
Copy Markdown

CLA Signature Pass

zheliuyu, thanks for your pull request. All authors of the commits have signed the CLA. 👍

@ascend-robot

Copy link
Copy Markdown

CLA Signature Pass

zheliuyu, thanks for your pull request. All authors of the commits have signed the CLA. 👍

@zheliuyu

zheliuyu commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator Author

Test Plan

  • DeepSpeed
  • LLaMA-Factory
  • VeOmni
  • verl
  • Triton-Ascend
  • ms-swift
  • onnxruntime

Result

截屏2026-08-13 15 07 16 截屏2026-08-13 14 10 41 截屏2026-08-13 14 13 58 截屏2026-08-13 14 19 53 截屏2026-08-13 14 20 35 截屏2026-08-13 14 21 21 截屏2026-08-13 14 37 36 截屏2026-08-13 14 45 19

@hipudding hipudding left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

b( ̄▽ ̄)d

@hipudding
hipudding merged commit 57120a9 into Ascend:main Aug 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants