AEM 文档历程 aem-documentation-journeys
文档历程通过将复杂和不同的功能捆绑在一起,以最佳做法方式解决业务目标,从而在AEM文档中提供了一种叙述性结构。 在设计时考虑了 AEM 初学者,历程将介绍概念和功能,以实现从 A 到 Z 的目标。
什么是文档历程? what-is
文档历程通过提供叙述来帮助可能是 AEM 新手的读者彻底理解和解决业务问题,同时假定读者拥有最少的主题或 AEM 知识,从而将许多不同且复杂的主题和功能联系起来。
文档历程与 AEM 现有的技术文档形成对比,这些文档主要侧重于单项功能和任务文档(假设您熟悉 AEM)。 文档历程将重点放在概念上,并将详细信息推迟到现有技术文档中,从而为刚接触 AEM 的读者提供一个新的平台,让他们能够开始了解如何通过使用最佳实践来满足常见的业务需求和工作流程来利用该平台。 因此,文档历程是对的补充,而不是 AEM 现有技术文档。
按叙事学习 narrative
AEM 具有丰富而强大的功能集,对于新用户(有时也是经验丰富的用户)而言,这些功能集非常强大。 通过以明确的业务目标而不是技术要求开始每个历程,历程可讲述如何引导读者了解 AEM 概念和功能,这些概念和功能可共同实现业务目标。
通过讲述一个故事,读者可以更好地理解 AEM 不同部分如何协同工作来解决手头的问题,并保持视角。 这样,读者就可以看到特征树的业务目标林。
关注概念而非功能 concepts
为了保持对叙述的关注,文档历程强调 AEM 中的概念,而不是强调技术特征。 认识到更重要的是,读者应该熟悉 AEM 如何解决特定问题,而不是担心要单击哪个复选框,这一历程使读者不断前进,说明如何将多个重要概念链接在一起,从而实现整体目标。
历程可确保读者了解 AEM 如何解决问题,而不必担心每个单击选项。 如果读者想要更深入地研究并了解更多技术细节或其他选项的用途,旅程的每个部分都会链接到相关的详尽技术文档。
最佳实践指南 best-practices
文档历程是围绕最佳实践原则设计的;这些原则基于由 Adobe 的最新研究、Adobe 服务提供的经验证的实施体验以及客户项目的反馈提供的信息。
如果您想了解 Adobe 如何推荐如何使用 AEM 解决业务案例,可以从文档之旅开始。
文档历程的结构如何? structure
文档历程是基于最佳实践的介绍,介绍 AEM 如何解决常见业务问题。 因此,每个历程的设计都考虑了 AEM 的新读者,列出了业务问题,描述了任何必要的理论,然后逐步概述了 AEM 如何解决该问题。 由于历程的综合性质,它对于初次接触 AEM 的读者以及经验丰富的用户都非常有用。
典型的文档历程包含以下部分。
- 历程目标和目标受众概述
- 业务问题的描述
- 对解决问题所必需的任何理论的描述
- 先决条件和要求
- 目标受众的描述
- 实施步骤
文档历程的目标是让读者熟悉 AEM 如何使用不同功能和工具解决单个业务问题的基础知识。 因此,实施步骤说明了最常见的使用模式以及最重要的功能和选项。 详细配置选项在技术文档中链接,以供进一步阅读。
谁应该阅读文档历程? who
AEM 文档历程的主要目标是帮助初次接触 AEM 的读者了解系统中有多少不同且功能强大的功能可以通过叙述方式一起用于解决常见的业务问题。
因此,如果您是初次使用 AEM,并且想要了解具体的业务案例,并想要概述 AEM 如何解决它,则需要开始使用文档历程。
但是,有许多不同类型的 AEM 用户具有不同的需求和期望。 例如:
- 管理员
- 开发人员
- 内容作者
- 翻译专家
- 内容架构师
每个历程都以历程的目标受众的明确说明开始。 因为没有人在真空中工作,当读者需要系统用户或角色的输入帮助时,历程中就清楚地解释了这一点。
文档历程如何适合 AEM 文档? compare
文档历程旨在补充现有 AEM 技术文档和教程。 例如,历程可能会向您介绍一个概念,技术文档将介绍您可能需要的详细配置选项,并且教程将指导您完成特定设置。
有哪些历程? journeys
已有若干文档历程可供您使用。由于每个历程都设计为叙述性的,因此请从介绍开始,并全面阅读,以便在AEM的上下文中充分了解该主题。