docs: 统一目标入口与学习路线选择 - #165
Open
yiweinanzi wants to merge 1 commit into
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
首次访问仓库时,首页把开发岗、算法岗和科研专题并列,新手入口又分别指向简版路线、六步求职流程等材料,读者难以判断从哪里开始、哪些资料必须读。本 PR 将首页入口统一为系统学习、做项目、准备面试、科研探索;系统学习先判断基础,再选择开发岗或算法岗主线。
四条阅读路径的前后对照
四个目标采用相同层级,均可从首页一次点击进入对应导航。其下的“按技术主题查找”统一进入文档总导航,主题索引用于回查具体内容,不另设学习主线。
修改范围
仅修改四个文档入口:
README.md:前置四类目标,合并重复入口,统一新手与学习路线链接,说明六步路径和八阶段 Todo 的求职准备、产出检查用途。docs/README.md:沿用相同目标名称,区分目标导航与主题查找,将路线选择集中到路线导航。docs/00-getting-started/README.md:明确“学习地图 → 七日计划”、基本编程与 API 前置知识,并补上入门后的主线分流。docs/05-roadmaps/README.md:先区分基础,再选开发岗/算法岗两条主线;将其余四份路线标为总览、求职产出检查、前沿算法扩展、VLA 扩展,并说明下一步入口。从最新
main(24082336)建立独立分支,未带入上一轮试做改动。现有长文、文件位置、元数据、引用来源与自动生成索引保留,网站不在本次修改范围内。验证
python scripts/manage_content_catalog.py --check:通过,20 个公开索引、137 篇文档、16 条 Backlog。python tests/markdown_links.test.py:通过,192 个源文件。python tests/repository_automation.test.py:通过。git diff --check:通过。github-slugger比对修改前后标题及锚点:四页原有 110 个标题和对应锚点全部保留,四页 19 处本地片段链接逐项通过。#项目与资源仍可用。本 PR 的 CI 已全部通过:Content and repository checks、Research site build、InterviewGuide test and build、Assemble and smoke-test Pages。当前等待正常 PR 评审与合并。