风格指南和内容模型
了解我们如何保持 GitHub 文档的一致性、易于理解和可维护性。
风格指南
遵循本指南,确保 GitHub 文档保持一致,并遵循读者能够理解的清晰模式。
关于内容模型
内容模型描述了我们发布内容的结构和类型。
GitHub Docs 文章的内容
每篇文章都包含一些标准元素,并且可能包含条件或可选元素。我们还在文章中使用标准内容顺序。
关于主题
使用主题使文章易于搜索。
概念性内容类型
当人们学习对他们来说全新的内容时,他们最常使用概念性内容。
参考性内容类型
参考性内容提供人们在积极使用功能时所需的详细信息。
程序性内容类型
程序性内容提供有关任务如何融入某人更大目标的上下文。
故障排除内容类型
故障排除内容包含我们期望人们遇到的内置错误、报告给支持部门的常见问题以及人们在完成任务时可能遇到的情况。
发行说明内容类型
发行说明使读者能够理解并为 GitHub 版本化企业产品的每个版本的对用户可见的更改做好准备。
快速入门内容类型
快速入门最适合希望快速获得说明,而无需详细解释内容如何工作或为什么要使用它的用户。
教程内容类型
当某人对产品有基本了解并有兴趣扩展其理解以解决特定问题时,教程很有用
关于组合多种内容类型
您可以在一篇文章中组合多种内容类型,以帮助人们完成复杂的任务。