使用GitHub Web界面创建目标文档页面

以下说明将向您展示如何使用GitHub Web界面创作文档和提交拉取请求(PR)。 在完成此处指示的步骤之前,请确保已阅读在Adobe Experience Platform目标中记录目标

设置GitHub创作环境

  1. 在浏览器中,导航到https://github.com/AdobeDocs/experience-platform.en

  2. 要创建分支存储库,请单击​分支,如下所示。 这会在您自己的GitHub帐户中创建Experience Platform存储库的副本。

    分支Adobe文档存储库

  3. 在存储库的分支中,为项目创建新分支,如下所示。 将这个新分支用于您的工作。

    新建GitHub分支

  4. 在分支存储库的GitHub文件夹结构中,导航到experience-platform.en/help/destinations/catalog/[...],其中[...]是目标的所需类别。 例如,如果要将个性化目标添加到Experience Platform,请选择personalization类别。 选择​添加文件>创建新文件

    添加新文件

  5. 将目标命名为YOURDESTINATION.md,其中YOURDESTINATION是您在Adobe Experience Platform中的目标名称。 例如,如果您的公司名为Moviestar,则需要将文件命名为moviestar.md

为您的目标创作文档页面

  1. 您将根据文档自助模板创建目标页面的内容。 🔗 下载模板并解压缩以提取文 .md 件模板。

  2. 在在线Markdown编辑器中粘贴和编辑模板的内容以及目标的相关信息,如dillinger.io。 有关应填写哪些内容以及可以删除哪些段落的详细信息,请按照模板中的说明进行操作。

    小贴士

    您可以随时关闭浏览器窗口,稍后重新打开。 您的工作会自动保存,在您重新打开浏览器时,将等待您完成。

    3. 将内容从Markdown编辑器复制到GitHub中的新文件中。
  3. 对于您计划使用的任何屏幕截图或图像,请使用GitHub界面将文件上传到experience-platform.en/help/destinations/assets/catalog/[...],其中[...]是目标的所需类别。 例如,如果要将个性化目标添加到Experience Platform,请选择personalization类别。 您需要从要创作的页面链接到图像。 请参阅说明如何链接到图像

    将图像上传到GitHub

  4. 准备就绪后,将文件保存在分支中。

确认文件创建

提交文档以供审核

小贴士

请注意,这里没有什么可以打破的。 按照此部分中的说明,您只是建议进行文档更新。 您建议的更新将由Adobe Experience Platform文档团队批准或编辑。

  1. 保存文件并上传所需的图像后,您可以打开拉取请求(PR),以将工作分支合并到Adobe文档存储库的主控分支中。 确保已选择您处理的分支,然后选择​Contribute > Open pull request

创建拉取请求

  1. 确保基分支和比较分支正确无误。 在PR中添加注释以描述您的更新,然后选择​创建拉取请求。 此操作将打开一个PR,将分支的工作分支合并到Adobe存储库的主控分支中。

    小贴士

    保持选中​允许维护者编辑​复选框,以便Adobe文档团队可以对PR进行编辑。

    创建拉取请求以Adobe文档存储库

  2. 此时会显示一则通知,提示您签署Adobe参与者许可协议(CLA)。 这是强制步骤。 签署CLA后,刷新PR页面并提交拉取请求。

  3. 您可以通过检查https://github.com/AdobeDocs/experience-platform.en中的​拉取请求​选项卡,确认已提交拉取请求。

    PR成功

  4. 谢谢!Adobe文档团队将在PR中联系,以防需要进行任何编辑,并告知您文档何时发布。

小贴士

要添加图像和文档链接,以及有关Markdown的任何其他问题,请阅读Adobe协作编写指南中的Using Markdown

在此页面上