Wiki 创建与维护

页面结构要求

• 每页必须包含： 清晰的标题、一句摘要、最后更新日期
• 统一使用模板 — 所有页面采用相同章节和顺序
• 保持页面聚焦 — 每页只讨论一个主题，超过约 500 字时应拆分
• 包含“快速入门”页面 — 用于展示整个 Wiki 的结构图谱

写作指南

• 面向零背景读者写作 — 不假设读者具备任何先验知识
• 将操作步骤写成编号列表，而非段落描述
• 尽可能包含示例和图表 — 缺少示例的 Wiki 只是术语词典
• 对不确定内容明确标注 — 使用 [需要验证] 或 [已过时] 标签

链接与组织

• 积极进行跨链接 — 每次提及其他概念时都应链接到对应页面
• 使用分类或标签 提升发现性，超越单纯链接关系
• 重命名时创建跳转页 — 确保不破坏原有链接
• 重构内容时维护链接完整性

内容维护

• 更新信息时，同步更新所有引用该信息的页面（可通过 grep 检查引用）
• 维护变更日志 或“最近更新”页面，供团队成员查看
• 定期内容审查 — 在信息过时导致误导前及时标记
• 统一格式规范 — 对所有贡献者强制执行

质量控制

• 审核新页面 是否符合模板要求及链接准确性
• 定期清理 孤立页面和失效内部链接
• 启用版本控制 以追踪变更并回滚错误
• 制定备份策略 保障内容持久保存与灾难恢复

成功指标

• 导航便捷 — 用户可在 <3 次点击内找到所需信息
• 页面自包含 — 每个页面能完整回答其主题问题
• 内容持续更新 — 定期维护确保信息时效性与价值