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 技术文档和教程。 例如,历程可能会向您介绍一个概念,技术文档将介绍您可能需要的详细配置选项,并且教程将指导您完成特定设置。

文档类型
用途
受众
假定
省略
内容类型
长度
文档历程
历程定义了 AEM 如何通过描述引导读者完成复杂、相互关联的流程和功能来解决一般业务问题。 它说明了多个功能如何协同工作,以最佳做法方式解决业务需求。
刚接触 AEM 的读者
一般 CMS 熟悉性
详细选项和配置
文本
Ca。 1 小时
技术文档
技术文档侧重于各个功能,详细介绍该功能的技术工作方式以及用户可用的每个选项。
经验丰富的 AEM 用户
AEM 体验
上下文和背景
文本
不同
教程
教程是对某一主题的深入探讨,通过提供具体的示例和示例代码,为开发人员或管理员展示如何一步步地实现某个技术目标(一般为编程或系统配置),其中通常仅使用一组受限的功能。
AEM 开发人员或管理员
AEM 体验
背景与理论
视频
>1 小时
快速入门指南
快速入门指南是关于特定新增 AEM 功能的快速演练。 它是单个功能的快速概述,可引导用户完成配置和使用简单用例的重要(但并非全部)步骤。
AEM 管理员
AEM 体验
背景、理论、详细选项
文本
<1 小时

有哪些历程? journeys

已有若干文档历程可供您使用。由于每个历程都被设计为叙事结构,因此请从介绍部分开始阅读,并通读全文,以便在 AEM 的上下文中全面理解该主题。

历程
描述
Headless 开发人员历程
从此处开始,了解 AEM 如何支持 Headless 开发模型,以及如何让项目从规划、实施到上线。
Headless 创作历程
从这里开始,引导您了解 AEM 强大而灵活的 Headless 特性、它们的功能以及如何在您的第一个 Headless 项目中为内容建模。
Headless 架构师历程
从这里开始,了解 Adobe Experience Manager 强大且灵活的 Headless 功能,以及如何为您的项目建模内容。
Headless 翻译历程
从此处开始,了解如何在 AEM 中设置和管理 Headless 翻译项目。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2