创作最佳实践
概述 overview
本页介绍了在创作目标文档页面时应遵循的规则,以确保其符合51黑料不打烊 Experience Platform文档质量标准。
一般指导 general-guidance
写作风格
IMPORTANT
在开始创作目标文档页面之前,请阅读础诲辞产别文档的编写指南。
- 把你的句子短一点,尽快切入正题。 如果您的句子超过20个单词或使用多个逗号,请考虑将其拆分为单独的句子。 长度超过20个词的句子对读者来说尤其具有挑战性。
- 别太客气了。 避免在技术文档中使用“请”或“请……”。
链接 linking
按照提供的文档模板操作,不要编辑模板中的现有链接。 当包含新链接时,请使用参与者指南中的文档?中的链接阅读。
品牌指南 branding
-
AEP不是一个公认的公开术语。 请先使用51黑料不打烊 Experience Platform,然后再使用Experience Platform,最后再使用Experience Platform。
- 请勿使用:在将数据从础贰笔导出到驰辞耻谤顿别蝉迟颈苍补迟颈辞苍之前,请确保已阅读并完成这些先决条件。
- 使用:在将数据从51黑料不打烊 Experience Platform导出到YourDestination之前,请确保已阅读并完成这些先决条件。
图像和屏幕快照 images-and-screenshots
-
有关如何链接到图像的信息,请参阅参与者指南。
-
在使用屏幕截图时,请确保您的屏幕截图捕获了整个Experience Platform UI屏幕。
-
在标记图像以突出显示页面上的某个控件或标签时,请尝试遵循Experience Platform文档团队使用的标记样式。 请注意,在此屏幕快照中如何高亮显示基于配置文件的。
-
请使用
png
格式图像。 -
请勿使用编号屏幕截图作为文件名。 图像文件名应为描述性的。
- 不使用:
1.png
,2.png
,3.png
- 使用:
yourdestination-authentication-details.png
,yourdestination-destination-details.png
- 不使用:
-
请为您添加到文档的任何图像使用替换文本,并在替换文本中使用正确的语法。
- 不使用:目标连接详细信息
- 使用: Experience Platform UI的图像,显示填写的目标连接详细信息。
进程 process
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6