Skip to main content

快速入门内容类型

快速入门最适合那些需要快速说明的读者,无需对工作原理或使用它的原因进行冗长的解释。

快速入门使用户能够在大约 5 分钟或 600 字内演示仅包含基本步骤的工作流,从而快速完成分散的重点任务。 快速入门可用于快速设置新工具,或快速完成其他任务。 对于更复杂的任务,请使用教程。

当某些读者已经了解功能或产品,而且准备好试用时,快速入门非常有用。

我们将教程和快速入门统称为整个网站的“指南”。 在 /guides 登陆页上,我们在文档集的指南列表中包括教程、快速入门和某些过程文章。

如何编写快速入门

有关快速启动模板,请参阅 模板

快速入门的内容:

  • 简介:
    • 强调该指南通过使用如下措辞提供快速和具有针对性的指导:
      • 快速将 [FEATURE] 添加到项目
      • [PRODUCT] 入门的基础知识
      • 面向熟悉 [FEATURE] 的人的简短指南
    • 阐明受众
    • 明确说明先决条件和所需的先验知识
    • 说明某人将完成或生成的内容
  • 过程部分
    • 根据快速入门的受众,这些步骤可能不如过程内容中使用的步骤明确和正式。 如果受众不需要该级别的详细信息,则不必使用现有的可重用内容来构成这些步骤。
    • 链接到其他文章或资源,而不是复制它们,以避免中断信息流。
    • 提供视觉提示。大量使用代码块和屏幕截图来帮助确保用户正在执行正确的操作。
  • 故障排除(可选)
    • 如果快速入门存在相关故障排除内容,请提供其链接。
  • 后续步骤
    • 提供快速入门中已完成的内容的简要概述,作为过渡到后续步骤的一种手段。
    • 包括 2-3 个可操作的后续步骤,用户可以在完成快速入门后执行这些步骤。 始终链接到有关功能或产品的概念性内容。 还可以链接到有关 docs.github.com 或 GitHub Skills 中的其他相关信息。

快速入门的标题指南

  • 当指南帮助某人开始使用新工具时,请在标题前面加上“快速入门”,例如“GitHub Actions 快速入门”或“快速入门:过程标题”。
  • 对于其他用例,请遵循过程标题指南并省略“快速入门”一词。

快速入门示例