Adobe 文档参与者指南
本指南介绍了如何为 Experience League 上的 Adobe Enterprise 帮助内容投稿。
什么是协作文档？
Adobe Experience Cloud 和其他 Adobe Enterprise 产品的技术文档和支持内容基于使用 GitHub、Markdown 和 Adobe Experience Cloud 解决方案的开源原则。
这种开源模型提升了内容质量，并且加强了客户、文档团队和产品团队之间的沟通。如今，您在每个页面上都可以评价内容实用性、记录问题，甚至可以将有关的内容建议作为 Git 拉取请求 (PR) 进行投稿。Adobe 文档团队每天都在检查投送的稿件和有关问题，并且会根据需要进行更新和调整。
使用协作文档
作为本材料的用户 - 无论您是员工、合作伙伴、客户还是潜在客户 - 您都可以选择采取以下几种简便的方式，为这类文档投稿。
- 评价页面是否有所帮助❶并撰写一条评论（可选）❷
- 针对特定页面报告相关问题（需要登录 Git）❸
- 从提交快速编辑内容，到创作整篇文章，包括资产和代码示例（需要登录 Git）❹
这些选项会在页面打开几秒钟后出现在页面底部。如果关闭反馈区域，您可以重新加载页面以将其恢复。
关于如何与这类文档材料小组进行互动以及如何投稿，本指南概述了您需要了解的所有相关内容。
评价页面是否有所帮助❶并撰写一条评论❷
打开页面几秒钟后，页面底部会出现一个反馈区域。向上或向下单击以指示该页面是否有帮助。
请随时发表评论以提供更多反馈。
对现有文档进行快速编辑
如果您想提供更详细的反馈，进行快速编辑是修复文档中的小错误和遗漏之处的好方法。提供有关文档编辑方面的建议时，您可以提交拉取请求 (PR) 以向我们提交修复/建议，之后，我们可以检查、批准和发布建议。
-
签署参与者许可协议 (CLA)（如果接受）。
您只需提交一次 Adobe CLA 即可。
-
在出现在文章底部的反馈区域中，单击详细的反馈选项，然后点击建议编辑，转到 GitHub 上的标记源文件。
-
单击铅笔图标可编辑相关文章。
注意如果铅笔图标呈灰显状态，则表明您需要登录您的 GitHub 帐户，或创建一个新帐户。
-
在 Web 编辑器中进行更改。
您可以单击 Preview changes（预览更改）选项卡以检查所做更改的格式。
-
完成更改后，滚动到页面底部。
输入 PR 的标题和描述，然后单击 Propose file change（建议文件更改），如下图所示：
注意如果您收到有关签署“参与者许可协议”(CLA) 的验证错误消息，请单击 Details（详细信息），以打开相关的许可协议。签署协议（如果接受）。接下来，关闭并打开拉取请求，然后继续操作。
以上就是所有步骤。文档团队成员将审核并合并您的拉取请求。谢谢！
报告问题
让我们了解某段内容中问题的另一种简单方法使用报告问题功能。
-
在出现在文章底部的反馈区域中，单击详细的反馈选项，然后点击报告问题，转到 GitHub 上的标记源文件。
注意若要报告问题，您必须登录 GitHub 帐户或创建一个帐户。
通过单击此链接，您可以使用“Github 问题”界面与 Experience League 一起快速记录问题。
描述字段中将自动填充存在问题的页面的 URL。
-
填写标题，简要描述问题，然后单击（提交新问题）。
提交问题会通知此页面的内容团队，他们可以解决您的问题。更新内容后，我们会通过“Github 问题”界面通知您，并且会在内容更新或关闭时通过电子邮件通知您。
了解 GitHub 权限
GitHub 编辑 UI 会根据您的存储库权限自行调整。对于不具有目标存储库写入权限的参与者，前面的图像是准确的。GitHub 会自动在您的帐户中创建目标存储库分支。如果您具有目标存储库的写入权限，GitHub 会在目标存储库中创建一个新分支。
Adobe 会对所有更改使用拉取请求，甚至对于具有写入权限的参与者也是如此。大多数存储库都会保护 main 分支，因此必须作为拉取请求来提交更新。
浏览器内编辑体验最适用于次要或不常见的更改。如果您要进行大量更改或使用高级 Git 功能，我们建议您创建分支存储库并在本地使用。
提供反馈
要设置与 Adobe 一样大型的解决方案，文档工作始终任重而道远。如果发现错误，请将问题记录下来；如果想提供有关材料的建议，请告知我们。告诉我们您需要的信息。如果您无法找到所需内容，请告知我们；或者如果您在完成任务时遇到困难，请告诉我们可以如何帮助您了解我们的解决方案。
请接受协作文档团队及 Experience League 中所有作者和内容制作者的谢意。
Business.Adobe.com 资源
