文档归属方案
云乐坊文档采用 wiki / docs / www / apps 分层,避免内部规划、对外开发者文档、官网帮助和产品实现文档混在同一个入口里。
站点职责
| 入口 | 主要受众 | 放什么 | 不放什么 |
|---|---|---|---|
wiki.yunle.fun | 内部成员 | 规划草案、架构决策、仓库职责、流程 SOP、上线检查、运营规则、排障手册 | 面向外部开发者的正式 API/接入文档 |
docs.yunle.fun | 外部开发者 | 接入指南、API/SDK、应用提交规范、审核标准、支付/云币/会员/SSO | 内部部署细节、账号权限、未定稿规划 |
www.yunle.fun/docs | 官网访问者 | 官网帮助、产品说明、法律条款、隐私政策、轻量入口页 | 完整技术文档体系 |
apps.yunle.fun/docs | 产品与工程维护者 | App 产品设计、工坊、应用目录、数据库模型、移动端实现笔记 | 组织级 SOP、外部正式开发者门户 |
当前规划归属
以下内容先沉淀在 wiki.yunle.fun,稳定后再提炼到 docs.yunle.fun:
- 新应用流程放在
www.yunle.fun、apps.yunle.fun还是admin的职责判断。 - 应用提交、审核、上架、工坊展示、离线快照生成的闭环设计。
wiki.yunle.fun、docs.yunle.fun、www.yunle.fun/docs、apps.yunle.fun/docs的边界。- 跨仓库类型、账号、支付、云币、会员、SSO 等公共能力的归属决策。
发布原则
- 还在讨论的规划、内部流程和仓库职责先进入
wiki.yunle.fun。 - 已经稳定、可以公开引用、外部开发者需要执行的内容整理到
docs.yunle.fun。 - 官网
www.yunle.fun/docs只保留轻量说明和入口链接,不扩展为主文档站。 - 产品实现细节保留在对应工程仓库,例如
apps.yunle.fun/docs。 - 同一份事实只维护一个真相源;其他站点用摘要和链接,不复制长文。
新应用流程文档落点
| 内容 | 推荐位置 |
|---|---|
| 内部职责划分与规划决策 | wiki.yunle.fun |
| 开发者如何提交应用 | docs.yunle.fun |
| 应用审核标准与公开政策 | docs.yunle.fun |
| 运营如何审核、推荐、生成快照 | wiki.yunle.fun |
工坊产品设计与 apps 集合模型 | apps.yunle.fun/docs |
| 官网介绍、下载入口、钱包入口 | www.yunle.fun |
当前状态
docs.yunle.fun 是规划中的对外开发者文档主站。正式建站前,对外可用内容可以先在 www.yunle.fun/docs 或相关仓库文档中保留轻量版本;内部决策仍以本页和 Wiki 相关页面为准。