Skip to content

docs: 站点 wiki 化重构第一阶段(认识 NBTCA + 概念库 + 编辑标准)#138

Merged
m1ngsama merged 12 commits into
mainfrom
feat/wiki-reconstruction
Jul 9, 2026
Merged

docs: 站点 wiki 化重构第一阶段(认识 NBTCA + 概念库 + 编辑标准)#138
m1ngsama merged 12 commits into
mainfrom
feat/wiki-reconstruction

Conversation

@m1ngsama

@m1ngsama m1ngsama commented Jul 9, 2026

Copy link
Copy Markdown
Member

Summary

把文档站重构成一座 wiki:面向不了解本社区的读者,词条自足、可即时查阅。新增「认识 NBTCA」栏目与概念库,教程与流程合并为「指南」,维修/概念/关于改为「枢纽 + 内链 + 搜索」模型,并加入构建期悬停预览卡与统一的视觉识别。同时收敛此前的治理脚手架。

Scope

  • Tutorial
  • Process
  • Repair
  • Archived
  • Navigation
  • Assets or templates
  • CI or tooling
  • Governance docs

Checklist

  • I updated the relevant sidebar or confirmed no navigation change is needed.
  • I checked internal links and asset paths affected by this PR.
  • I kept historical archived content unchanged — except migrating active manuals out of archived/manual/ (intentional archive maintenance).
  • I documented follow-up work that is intentionally outside this PR.

Verification

  • pnpm run ci:lint
  • pnpm test run
  • pnpm docs:build

Notes

待补的事实(只有真人知道,没编,留了占位;完整清单见 docs/reconstruction-notes.md):

  • 维护信息占位:apply-for-creditsborrow-classroom 两页维护人时间仍是 ??? - ???
  • 历届表:19 / 21 届宣传·组织、24 / 25 届多数岗位仍「待补」。
  • 维修日当日流程:repair/repair-day.md 三处〔待核实〕。
  • 存根词条:院青协、DEV101、百团大战、迎新会、每周学习日。

治理收敛:删除 AI 脚手架式的 CONTEXT.mddocs/adr/(与 CONTRIBUTING 重复且描述的是重构前的旧导航模型);精简 CONTRIBUTING 到当前的枢纽/指南结构;收窄 CODEOWNERS——去掉 catch-all,将文档评审指向会长与 documents 主力。

后续单开 PR:内容契约覆盖重构(把「必须进边栏」与「质量检查」拆开)、悬停卡数据加载器补单测、首页 logo 自托管。

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 9, 2026

Copy link
Copy Markdown

Deploying documents with  Cloudflare Pages  Cloudflare Pages

Latest commit: 86cebf9
Status: ✅  Deploy successful!
Preview URL: https://73c3e361.documents-dq4.pages.dev
Branch Preview URL: https://feat-wiki-reconstruction.documents-dq4.pages.dev

View logs

m1ngsama added 7 commits July 9, 2026 14:46
Build-time page-preview loader powers Wikipedia-style hovercards; add hub back-link and page transitions. Brand blue #124689 from the logo, with a monospace voice for metadata. Nav narrowed to about / guide / repair.
Flagship what-is-NBTCA plus join, organization & history, and infrastructure pages. The section's primary audience is people who do not yet know the community.
Self-contained concept entries whose first paragraph powers the hover preview; internal links are all previewable entries.
The repair index becomes a hub linking guide, weekend, tools, checklist and repair-day; the section sidebar is dropped in favor of inline links, previews and search.
…rchive

Merge tutorial and process into a single guide nav entry and sidebar; move active manuals out of archived and trim AI-generated filler.
Exclude hub sections from the sidebar-coverage contract and drop the obsolete repair sidebar test.
The writing and fact-checking standard, plus PR handoff notes; both are srcExcluded and not published.
@m1ngsama m1ngsama force-pushed the feat/wiki-reconstruction branch from c5a5c81 to 2a90a38 Compare July 9, 2026 06:48
…ting

Remove the AI-scaffolded CONTEXT.md and docs/adr, which duplicated CONTRIBUTING and described the pre-reconstruction navigation model. Slim CONTRIBUTING to the current hub/guide layout. Narrow CODEOWNERS: drop the catch-all second owner and route documentation review to the president and the documents maintainers.
@m1ngsama m1ngsama removed the request for review from Orangedog433 July 9, 2026 07:13
m1ngsama added 4 commits July 9, 2026 15:30
These entries were linked from other pages but linked nowhere themselves; add back-links to related concepts to improve wiki navigability. Leaf concepts (school-calendar, school-identity) are intentionally left as terminal definitions.
…st read

The 维护信息 provenance stamp previously sat between the H1 and the lead paragraph on every page, pushing the actual content down. Relocate it to the foot of each page (Wikipedia-style) so the definition/lead follows the title directly; provenance is preserved, just no longer competing with the opening.
@m1ngsama m1ngsama merged commit 570767e into main Jul 9, 2026
5 checks passed
@m1ngsama m1ngsama deleted the feat/wiki-reconstruction branch July 9, 2026 08:49
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.

2 participants