大多数软件包都需要某种形式的注解，以帮助用户获得最佳体验并优化其使用。本页面提供了一些有关如何结构化信息和格式化文档的技巧。
在软件包的标题之后，提供有关软件包及其内容的基本概述。在概述和软件包内容之后，包括安装说明、系统要求和限制。您还可以提供获取帮助和提供反馈的链接，包括公共论坛或知识库以及支持联系人。
在获得这些初步信息之后，您可以提供更深入的工作流程、用户界面描述或示例目录列表，以及更高级的主题。参考页最好在最后提供。
| 部分 | 描述 |
|---|---|
| 概述 | 软件包的简要、概括性描述。 |
| 软件包内容 | 包括您希望用户知道的重要文件的位置。例如，如果这是一个包含了纹理、模型和材质的示例包，且按示例组进行了分隔，则您可能需要指定每个组的文件夹位置。 |
| 安装说明 | 您可以提供指向官方的 Package Manager 安装说明的链接，但是如果您有任何特殊的安装需求，比如安装示例，可以在这里添加。 |
| 要求 | 这是添加硬件或软件要求合适的位置，包括此软件包与哪些版本的 Unity 编辑器兼容。 |
| 限制 | 如果您的软件包有任何已知限制，可在此处列出。如果没有限制，或者限制是微不足道的，可去除此部分。 |
| 工作流程 | 包括用户可以遵循的步骤列表，以演示如何使用该功能。您可以附上屏幕截图来帮助描述如何使用该功能。 |
| 高级主题 | 有关向用户提供的内容的详细信息。如果您不希望用户一开始就面对太多信息，这是理想的选择。 |
| 参考 | 如果您的用户界面具有很多属性，则可以在参考部分中对其进行详细介绍。使用表格提供特定属性描述是一种好方法。 |
| 示例 | 对于包含示例文件的软件包，您可以包含有关用户如何在其项目和场景中使用这些示例文件的详细信息。 |
| 教程 | 如果您想为复杂程序提供演示，您也可以在此处添加。使用分步说明，并附上可以帮助用户理解的图像。 |
Markdown 是一种软件包中常用的轻量级格式。许多代码仓库托管服务（例如 GitHub 和 Bitbucket）都支持 Markdown 格式的 README 文件和文档站点。您可以在软件包根目录下的 Documentation~ 文件夹中添加一个 Markdown 文件。然后，当用户单击 Unity Package Manager 窗口的详情面板中的文档链接时，用户的默认 Markdown 查看器将打开该文件。
您还可以使用自己的网站来存放您的文档。要设置指向自己网站的文档链接的位置，请使用 package.json 文件中的 documentationUrl 属性进行设置。
如果决定使用 Markdown 来记录软件包，可以从许多站点中找到有关编写 Markdown 文件的信息，包括：