AEM Documentation Journeys

A Documentation Journey ties together many different and perhaps complicated topics and features by providing a narrative that helps the reader, who can be new to AEM, understand and solve a business problem from beginning to end, while assuming minimal prior topic or AEM knowledge.

Documentation Journeys are designed around best practices principles, informed by Adobe’s latest research, proven implementation experience from Adobe consultants, and feedback from customer projects.

If you want to know how Adobe recommends how to solve headless business cases with AEM, AEM Headless Journeys are where to start.

Audience

This journey is designed for the translation specialist persona, often referred to as the Translation Project Manager or TPM. This journey lays out the requirements, steps, and approach to translate headless content in AEM. The journey may define additional personas with which the translation specialist must interact, but the point-of-view for the journey is that of the translation specialist.

This journey assumes the reader has experience translating content on a large CMS system, but assumes no knowledge of headless technology or AEM.

The following are the personas that interact in this journey.

PersonaDescriptionRole in Journey
Translation SpecialistDefines what content should be translated and manages those workflowsAudience of this journey
Content AuthorCreates and manage content that is delivered headlesslyContent Authors create content that the translation specialist must translate.
AdministratorManages the base setup and configuration of AEMThe translation specialist works with the administrator to make configuration changes needed for translation such as installing a translation connector.
Content ArchitectAnalyzes the requirements for the data that must be delivered headlessly and defines the structure for this dataTranslation specialists work with the content architect to define the organization of the content so it can be easily translated.

Information in this journey can be useful to all personas, but some information may be superfluous to certain roles. Stay tuned for forthcoming journeys covering additional roles.

The Headless Translation Journey

You will explore many topics in this journey. The following articles give you foundational knowledge of translating headless content in AEM and link out to detailed technical documentation.

Although you can go directly to a particular part of the journey, many concepts build on ones in previous articles. Therefore if you are new to headless translation in AEM, Adobe recommends that you start at the beginning and progress sequentially.

#ArticleDescription
0AEM Headless Translation JourneyThis document
1Learn about headless content and how to translate it in AEMLearn headless concepts, how they map to AEM, and the theory of AEM translation.
2Get started with AEM headless translationGet to know how to organize your headless content and how AEM’s translation tools work.
3Configure the translation integrationLearn how to connect AEM to a translation service.
4Configure translation rulesLearn how to define translation rules to identify content for translation.
5Translate contentUse the translation integration and rules to translate your headless content.
6Publish translated contentLearn how to publish your translated content and update the translation when the underlying content is updated.

What’s Next

You are now ready to get started on your Adobe headless translation journey. We encourage you to continue on to the next part of the journey and read the article Learn about headless content and how to translate it in AEM