Shopify 知识库如何组织与核验

整理 Shopify 资料时，按业务对象和平台能力组织正文，按用户旅程和实际任务提供导航。域名、后台菜单、截图和零散观察是素材，不能直接当作知识目录。

一篇文章先说明读者的问题和任务，再给出适用条件、直接结论、操作或实验过程、证据、限制、官方来源和核验日期。概念解释、操作指南、方案比较、故障排查和实验记录使用不同文章类型；一次实验的结果不能直接写成平台通则。

同一概念只维护一份正文。专题和阅读路线通过关联 ID 引用正文，不复制内容；讨论中形成的结论写回对应正文，并保留原讨论的上下文。

本站的 Shopify 部分按这一方法组织为平台生态与入口、店铺经营、店面与主题、交易履约、应用集成、数据自动化和 DTC 方法论几条主线；每篇文章的证据状态和核验日期单独标注。

把素材写成可以独立阅读的文章

建议按以下顺序写作：

1. 写清读者的问题和要完成的任务。
2. 列出与问题有关的版本、套餐、账户模式或环境条件。
3. 先给直接结论，再解释必要的概念。
4. 保留操作步骤、请求响应或其他关键证据，并说明如何检查结果。
5. 区分常见误解、适用限制和未解决问题。
6. 附来源、关联条目与核验日期；核验日期应对应实际检查，不能只因改稿而刷新。

白板或关系图要说明每条连线的含义。把节点转成文字时补足关系解释，移除图片后正文仍应表达核心结论。截图要记录时间与环境；无法补齐条件的截图只能作为历史观察。

按影响排序补齐证据

补充知识时先处理影响最大的缺口，而不是追求篇数：

1. 高影响结论有来源和适用条件，或明确标为待核验。
2. 同一个需求能找到所属能力和管理入口，关系图中的连线含义明确。
3. 端到端案例能关联概念、操作与数据口径，他人可按条件复现。
4. 新专题有具体读者任务，与已有正文分工明确。

把多个专题合并前，先比较各自覆盖的主题和正文质量，再确定权威正文放在哪里。没有检查过的材料，不能直接判断应当合并还是迁移。

从生态与知识库阅读导引进入业务框架与任务路线；涉及具体技术断言时，对照优先核验清单补证据。