这是 Beta 课程,内容结构、章节安排和示例可能会继续调整。
《Cloudflare 入门》读者视角问题清单
检查时间:2026-06-04
检查范围:content/courses/zh-cn/cloudflare 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理,优先级越高,越可能直接导致读者中断阅读、误解知识或不信任课程。
P0:会直接阻断学习的问题
暂未发现会直接阻断学习的 P0 问题。
P1:结构和学习路径问题
1 个章节索引页缺少导读
受影响文件:
content/courses/zh-cn/cloudflare/index.mdx
这些索引页通常只有标题或封面组件,没有说明本章要解决什么问题、子章节顺序、前置知识或读完后的能力目标。读者进入章节入口时会缺少方向。
建议:每个章节索引至少补“本章问题、学习目标、建议阅读顺序、可跳过/需预备的内容”。如果只是导航占位,建议暂时隐藏。
课程首页缺少读者路径说明
受影响文件:
content/courses/zh-cn/cloudflare/index.mdx
首页正文信息量偏少,读者很难判断课程适合谁、需要哪些基础、应该按什么路线学习,以及学完能解决什么问题。
建议:补充适合读者、前置知识、章节地图、推荐路径和最终学习产出。
1 个练习页缺少答案或反馈
受影响文件:
content/courses/zh-cn/cloudflare/service-bindings.mdx
课程包含练习或自测,但缺少答案、提示、常见错误或判断标准。自学读者做完后无法确认是否理解正确。
建议:为每个练习补参考答案折叠区;复杂题至少提供提示、关键步骤和最终结果。
4 个同级页面共享相同 order
受影响文件:
content/courses/zh-cn/cloudflare/pages.mdxcontent/courses/zh-cn/cloudflare/smart-placement.mdxcontent/courses/zh-cn/cloudflare/r2.mdxcontent/courses/zh-cn/cloudflare/service-bindings.mdx
同一目录下多个页面使用相同 order,导航可能依赖文件名或构建器默认顺序,导致读者看到的章节顺序不稳定。
建议:同级页面使用唯一递增 order;若需要章节级排序和文章级排序,拆分字段或明确排序策略。
P2:阅读体验问题
2 个页面使用外部图片
受影响文件:
content/courses/zh-cn/cloudflare/service-bindings.mdxcontent/courses/zh-cn/cloudflare/smart-placement.mdx
课程关键图片依赖外部 URL,可能受网络、跨域、服务可用性影响;外部素材也不利于长期维护。
建议:把课程图片落到本地资源目录,并补充 alt 文本和简短图注。
建议修复顺序
- 补课程首页和章节索引导读。
- 统一同级页面 order。
- 给练习补答案或提示。
- 外部图片本地化。