《Docker 入门》读者视角问题清单

检查时间:2026-06-04

检查范围:content/courses/en/docker 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理,优先级越高,越可能直接导致读者中断阅读、误解知识或不信任课程。

P0:会直接阻断学习的问题

暂未发现会直接阻断学习的 P0 问题。

P1:结构和学习路径问题

1 个章节索引页缺少导读

受影响文件:

  • content/courses/en/docker/index.mdx

这些索引页通常只有标题或封面组件,没有说明本章要解决什么问题、子章节顺序、前置知识或读完后的能力目标。读者进入章节入口时会缺少方向。

建议:每个章节索引至少补“本章问题、学习目标、建议阅读顺序、可跳过/需预备的内容”。如果只是导航占位,建议暂时隐藏。

课程首页缺少读者路径说明

受影响文件:

  • content/courses/en/docker/index.mdx

首页正文信息量偏少,读者很难判断课程适合谁、需要哪些基础、应该按什么路线学习,以及学完能解决什么问题。

建议:补充适合读者、前置知识、章节地图、推荐路径和最终学习产出。

3 个页面文字依赖图示但没有实际图片

受影响文件:

  • content/courses/en/docker/02-docker-installation.mdx
  • content/courses/en/docker/07-docker-compose.mdx
  • content/courses/en/docker/08-docker-production-best-practices.mdx

正文出现“如下图”“观察图像”“示意图”等表达,但页面中没有可见图片或本地图示。对几何、架构、流程、算法类课程,这会明显降低理解速度。

建议:补本地图、组件图或至少给出可独立理解的文字兜底说明。

4 个练习页缺少答案或反馈

受影响文件:

  • content/courses/en/docker/04-dockerfile-basics.mdx
  • content/courses/en/docker/05-docker-data-management.mdx
  • content/courses/en/docker/07-docker-compose.mdx
  • content/courses/en/docker/08-docker-production-best-practices.mdx

课程包含练习或自测,但缺少答案、提示、常见错误或判断标准。自学读者做完后无法确认是否理解正确。

建议:为每个练习补参考答案折叠区;复杂题至少提供提示、关键步骤和最终结果。

10 个页面元数据不完整

受影响文件:

  • content/courses/en/docker/01-docker-introduction.mdx
  • content/courses/en/docker/02-docker-installation.mdx
  • content/courses/en/docker/03-docker-basic-commands.mdx
  • content/courses/en/docker/04-dockerfile-basics.mdx
  • content/courses/en/docker/05-docker-data-management.mdx
  • content/courses/en/docker/06-docker-networking.mdx
  • content/courses/en/docker/07-docker-compose.mdx
  • content/courses/en/docker/08-docker-production-best-practices.mdx
  • content/courses/en/docker/09-docker-troubleshooting.mdx
  • content/courses/en/docker/10-docker-practical-examples.mdx

缺少 title、课程/章节 description 或正文页 order 会影响导航、SEO、排序和卡片摘要。

建议:补齐标题、描述和排序字段,并确保同一目录下的排序规则稳定。

P2:阅读体验问题

暂未发现明显的阅读体验 P2 问题。

建议修复顺序

  1. 补课程首页和章节索引导读。
  2. 给练习补答案或提示。
  3. 补关键图示和文字兜底。