section-intro-guide

# R 入门指南 ## 开工 1. 先执行 `tutorial-authoring`，完整读取其质量标准，再读取 [content-structure.md](references/content-structure.md)。 2. 明确读者已经会什么、读完要完成什么任务，以及可用于练习的最小数据或文件。 3. 新建文章前核对 `00xx` 编号、相近主题、稳定 URL 和 `_quarto.yml` 位置。 4. 涉及 R、RStudio、Positron、Quarto 或包接口时核对当前官方文档；不要复用过期界面和安装步骤。 5. 按 [共同辨析合同](../tutorial-authoring/references/comparison-and-visuals.md) 判断当前任务是否涉及初学者容易混淆的相邻概念，例如对象类型、赋值与比较、向量化与循环、脚本与控制台。只有误解会影响当前任务时才比较，不提前堆进阶术语。 ## 教学主线 按学习问题组织内容，不固定章节数、行数或文字/代码比例。入门教程通常依次完成：建立任务语境、解释最少必要概念、给出可复制的最小示例、展示预期输出、让读者完成一个小练习，并说明失败时从哪里检查。 - 一个例子只引入少量新概念；后续例子复用前文对象，避免每节重新造数据。 - 代码块前说明输入和目的，代码块后解释输出中需要看的量；不逐行翻译显而易见的语法。 - 类比只用于建立直觉，随后明确其不能覆盖的技术边界。 - 易混淆概念在第一次代码使用前用最小反例、短表或对象结构说明；不要等到常见错误章节才纠正读者已经形成的误解。 - 错误示例必须能实际复现，并给出错误信息、最早检查点、原因和修复。 - 学习路线以能力和可验证任务分阶段，不承诺固定周数，也不把安装大量包当作学习成果。 需要编写路线图时读取 [learning-roadmap.md](references/learning-roadmap.md)。 ## 代码与环境 - 从空白 R 会话按文章顺序实跑全部可执行代码；随机过程才设置种子。 - 优先使用小而真实的数据结构，不通过隐藏 warning、错误或输出制造“顺利”体验。 - 安装与日常代码分开。缺少运行时、系统库或外部软件时遵循仓库依赖规则，不默认改全局环境。 - 展示文件路径时说明工作目录并使用本项目可复现的相对路径。 ## 图件 读取 [visual-templates.md](references/visual-templates.md)。真实控制台、编辑器、文档和图形均来自实际运行或渲染。只有关系、顺序或层级用文字难以追踪时才生成内容图；封面和示意图均不设数量指标。 ## 验证与导航 1. 运行项目教程审计脚本并实跑示例。 2. 定向渲染目标文章，检查代码、表格、图件、中文和移动端可读性。 3. 更新 `doc/_quarto.yml` 后从 `doc/` 运行 `Rscript generate_sections.R`。 4. 只渲染 `sections/guide.qmd`、`index.qmd` 与目标文章，扫描完整日志中的 warning/error。