Skip to content

docs: refactor documentation homepage with categorization#105

Merged
zheliuyu merged 2 commits intoAscend:mainfrom
justbin-coder:feature/portal-refactor
Feb 25, 2026
Merged

docs: refactor documentation homepage with categorization#105
zheliuyu merged 2 commits intoAscend:mainfrom
justbin-coder:feature/portal-refactor

Conversation

@justbin-coder
Copy link
Contributor

Description

本 PR 对昇腾开源文档首页 (index.rst) 进行了深度重构。

从“项目平铺”转向“场景应用导向”:将原本杂乱分布的 27 个组件按“基础框架、训练/微调、推理/部署、多模态应用/评测/对齐”四大功能定位进行重新分类。

Verification

  • 本地通过 make html 编译通过。

  • 在 Chrome/Edge 等主流浏览器下完成布局比例及响应式验证。

Fixes #103

@justbin-coder
Copy link
Contributor Author

ascend-docs

Copy link
Collaborator

@zheliuyu zheliuyu left a comment

Choose a reason for hiding this comment

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

Thanks for your contribution. Here are some review comments. I hope they are helpful.

@@ -0,0 +1,50 @@
Align the Inference results of the verl and vLLM frameworks on Ascend devices(zh)
Copy link
Collaborator

Choose a reason for hiding this comment

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

With #96's new approach, we can avoid keeping an extra copy since files for LLaMA-Factory, ms-swift, VeOmni, and verl are available directly via git submodule.

index.rst Outdated
:caption: 原生支持的AI项目
:caption: 🏗️ 基础设施与框架

sources/pytorch/index.rst
Copy link
Collaborator

Choose a reason for hiding this comment

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

Open-source libraries within the same category should be sorted in alphabetical order.

index.rst Outdated
:hidden:
:caption: 🧠 训练与微调框架

sources/verl/index.rst
Copy link
Collaborator

Choose a reason for hiding this comment

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

ditto

</div>
</div>
</div>
sources/Diffusers/index.rst
Copy link
Collaborator

Choose a reason for hiding this comment

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

ditto

@ascend-robot
Copy link

CLA Signature Guide

@1k77 , thanks for your pull request.

The following commit(s) are not associated with a signed Contributor License Agreement (CLA).

Commit Reason
f2f98b3d docs:optimize portal layout and ... the email used in the commit is not linked to a signed CLA!
please verify that it matches the email you used when signing the CLA.
893319c0 center align project logos on do... the email used in the commit is not linked to a signed CLA!
please verify that it matches the email you used when signing the CLA.
b8034563 Remove unused sources and sort l... the email used in the commit is not linked to a signed CLA!
please verify that it matches the email you used when signing the CLA.

To sign CLA, click here.

To check if your email is configured correctly, refer to the FAQs.

Once you've signed the CLA or updating your email, please comment /check-cla to revalidate CLA status.

@ascend-robot
Copy link

CLA Signature Pass

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

'sphinx_copybutton',
'sphinx_markdown_tables'
'sphinx_markdown_tables',
"sphinx_design",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Sorry I missed that last time. sphinx_design should be included in requirements.txt so that it gets installed.

../_generated/sources/verl/ascend_profiling_en
../_generated/sources/verl/ascend_profiling_zh
../_generated/sources/verl/ascend_consistency
ascend_quick_start.rst
Copy link
Collaborator

Choose a reason for hiding this comment

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

It appears there is an issue with the file reading path in verl that requires adjustment.

Image

@ascend-robot
Copy link

CLA Signature Pass

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

@zheliuyu
Copy link
Collaborator

Thanks for your contribution. Let's merge this PR to proceed with the follow-up work.

@zheliuyu zheliuyu merged commit 84866b6 into Ascend:main Feb 25, 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.

[RFC][Sub] UI/UX Refactoring for Portal & Navigation (Follow-up #97)

4 participants