《Computer Networks》读者视角问题清单

检查时间:2026-06-04

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

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

33 个正文页接近空骨架,读者点进去没有可学习内容

受影响文件:

  • content/courses/en/computer_networks/01.network-architecture/01.basic-concepts.mdx
  • content/courses/en/computer_networks/01.network-architecture/02.performance-metrics.mdx
  • content/courses/en/computer_networks/01.network-architecture/03.layered-structure.mdx
  • content/courses/en/computer_networks/01.network-architecture/04.osi-model.mdx
  • content/courses/en/computer_networks/01.network-architecture/05.tcp-ip-model.mdx
  • content/courses/en/computer_networks/01.network-architecture/06.network-devices.mdx
  • content/courses/en/computer_networks/01.network-architecture/07.exercises.mdx
  • content/courses/en/computer_networks/02.physical-layer/01.communication-basics.mdx
  • content/courses/en/computer_networks/02.physical-layer/02.transmission-theory.mdx
  • content/courses/en/computer_networks/02.physical-layer/03.encoding-modulation.mdx
  • content/courses/en/computer_networks/02.physical-layer/04.switching-techniques.mdx
  • content/courses/en/computer_networks/02.physical-layer/05.transmission-media.mdx
  • 另有 21 个同类文件未列出。

这些页面基本只剩 frontmatter、标题、组件或极少量说明,无法承接课程路径。读者会以为内容未完成,尤其当它们出现在章节中部时,会直接中断学习。

建议:补齐正文、例题、阶段小结和必要图示;若短期无法补齐,先从导航中隐藏或标注为未完成。

P1:结构和学习路径问题

6 个章节索引页缺少导读

受影响文件:

  • content/courses/en/computer_networks/01.network-architecture/index.mdx
  • content/courses/en/computer_networks/02.physical-layer/index.mdx
  • content/courses/en/computer_networks/03.data-link-layer/index.mdx
  • content/courses/en/computer_networks/04.network-layer/index.mdx
  • content/courses/en/computer_networks/05.transport-layer/index.mdx
  • content/courses/en/computer_networks/06.application-layer/index.mdx

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

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

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

受影响文件:

  • content/courses/en/computer_networks/02.physical-layer/07.exercises.mdx

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

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

8 个页面元数据不完整

受影响文件:

  • content/courses/en/computer_networks/01.network-architecture/01.basic-concepts.mdx
  • content/courses/en/computer_networks/01.network-architecture/02.performance-metrics.mdx
  • content/courses/en/computer_networks/01.network-architecture/03.layered-structure.mdx
  • content/courses/en/computer_networks/01.network-architecture/04.osi-model.mdx
  • content/courses/en/computer_networks/01.network-architecture/05.tcp-ip-model.mdx
  • content/courses/en/computer_networks/01.network-architecture/06.network-devices.mdx
  • content/courses/en/computer_networks/01.network-architecture/07.exercises.mdx
  • content/courses/en/computer_networks/syllabus.mdx

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

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

2 个同级页面共享相同 order

受影响文件:

  • content/courses/en/computer_networks/02.physical-layer/02.transmission-theory.mdx
  • content/courses/en/computer_networks/02.physical-layer/index.mdx

同一目录下多个页面使用相同 order,导航可能依赖文件名或构建器默认顺序,导致读者看到的章节顺序不稳定。

建议:同级页面使用唯一递增 order;若需要章节级排序和文章级排序,拆分字段或明确排序策略。

P2:阅读体验问题

图像和可视化资源偏少

检查到本课程共有 40 个 MDX 页面,但图片/本地图示引用约 0 处。对当前主题来说,读者需要通过图示理解结构、空间关系、流程或公式含义;只靠文字会增加学习负担。

建议:优先给核心概念页补图,例如课程首页、章节索引、最容易误解的推导/流程页。每张图应配短说明,不要只放装饰图。

建议修复顺序

  1. 补齐或隐藏空骨架正文页。
  2. 补课程首页和章节索引导读。
  3. 统一同级页面 order。
  4. 给练习补答案或提示。
  5. 补关键图示和文字兜底。