This is a beta course, so its structure, chapters, and examples may continue to change.
《Introduction to Astro》读者视角问题清单
检查时间：2026-06-04
检查范围：content/courses/en/astro 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理，优先级越高，越可能直接导致读者中断阅读、误解知识或不信任课程。
P0：会直接阻断学习的问题
1 个页面疑似把重复 frontmatter 暴露到正文
受影响文件：
content/courses/en/astro/03.docs-site.mdx
页面正文中再次出现 lastChecked、title、description、order 或额外的 ---，很可能会被渲染成读者可见的异常文本。
建议：删除重复元数据，只保留文件开头的一段 frontmatter。
P1：结构和学习路径问题
4 个页面文字依赖图示但没有实际图片
受影响文件：
content/courses/en/astro/03.docs-site.mdxcontent/courses/en/astro/05.server-side-api.mdxcontent/courses/en/astro/06.data-and-content.mdxcontent/courses/en/astro/index.mdx
正文出现“如下图”“观察图像”“示意图”等表达，但页面中没有可见图片或本地图示。对几何、架构、流程、算法类课程，这会明显降低理解速度。
建议：补本地图、组件图或至少给出可独立理解的文字兜底说明。
4 个练习页缺少答案或反馈
受影响文件：
content/courses/en/astro/02.components-and-pages.mdxcontent/courses/en/astro/03.docs-site.mdxcontent/courses/en/astro/05.docs-deploy.mdxcontent/courses/en/astro/06.data-and-content.mdx
课程包含练习或自测，但缺少答案、提示、常见错误或判断标准。自学读者做完后无法确认是否理解正确。
建议：为每个练习补参考答案折叠区；复杂题至少提供提示、关键步骤和最终结果。
P2：阅读体验问题
暂未发现明显的阅读体验 P2 问题。
建议修复顺序
- 删除重复 frontmatter。
- 给练习补答案或提示。
- 补关键图示和文字兜底。