AEM Parcours de documentation

Les Parcours de documentation fournissent une structure narrative dans AEM documentation en liant des fonctionnalités complexes et disparates afin de résoudre un objectif commercial d’une manière conforme aux bonnes pratiques. Conçu pour les AEM débutants, parcours présente les concepts et les fonctionnalités pour atteindre un objectif de A à Z.

Qu’est-ce qu’un Parcours de documentation ?

Un Parcours de documentation relie de nombreux sujets et fonctionnalités différents et complexes en fournissant un récit qui aide le lecteur, qui peut être nouveau pour AEM, comprendre et résoudre un problème commercial du début à la fin, tout en assumant un minimum de connaissances préalables ou AEM.

Les Parcours de documentation contrastent avec AEM documents techniques existants qui se concentrent principalement sur une seule fonctionnalité et sur la documentation des tâches, en tenant compte de la familiarité avec AEM. En se concentrant sur les concepts et en renvoyant des détails détaillés à la documentation technique existante, les Parcours de documentation offrent aux lecteurs un nouvel AEM pour commencer à comprendre comment la plateforme peut être exploitée en utilisant les bonnes pratiques pour répondre aux besoins et aux workflows courants de l’entreprise. C’est pourquoi les Parcours de documentation servent de complément et non de remplacement pour AEM la documentation technique existante.

Apprentissage par narration

AEM dispose d’un ensemble de fonctionnalités riche et puissant, qui peut s’avérer fastidieux pour les nouveaux utilisateurs (et parfois expérimentés). En commençant chaque parcours par un objectif opérationnel clair plutôt que par des exigences techniques, un parcours raconte au lecteur les concepts et les caractéristiques AEM qui unissent leurs efforts pour atteindre l'objectif opérationnel.

En racontant une histoire, le lecteur comprend mieux comment les différentes parties de l'AEM travaillent ensemble pour résoudre le problème et garder une perspective inchangée. Ainsi, le lecteur peut voir la forêt des objectifs commerciaux pour les arbres de caractéristique.

Concentrez-vous sur les concepts et non les fonctionnalités

Pour se concentrer sur la narration, les Parcours de documentation mettent l’accent sur les concepts d’AEM plutôt que sur les caractéristiques techniques. Comme il est plus important que le lecteur sache comment AEM résoudre un problème particulier plutôt que de se soucier des cases à cocher, le parcours fait avancer le lecteur à travers le récit, illustrant comment relier plusieurs concepts importants afin d'atteindre l'objectif général.

Parcours s’assure que le lecteur sait comment AEM peut résoudre un problème au lieu de s’inquiéter de chaque option à cliquer. Si le lecteur souhaite approfondir ses connaissances et en apprendre davantage sur les détails techniques ou sur les options supplémentaires à proposer, chaque partie du parcours renvoie à une documentation technique exhaustive.

Orientation des bonnes pratiques

Les Parcours de documentation sont conçus autour des principes de bonnes pratiques, reposant sur les dernières recherches de l’Adobe, l’expérience de mise en oeuvre éprouvée des services Adobe et les commentaires des projets clients.

Si vous souhaitez savoir comment Adobe recommande de résoudre un cas d’entreprise avec AEM, les Parcours de documentation sont les points de départ.

Comment est structuré un Parcours de documentation ?

Un Parcours de documentation sert d’introduction aux bonnes pratiques sur la manière dont AEM résout les problèmes courants de l’entreprise. C'est pourquoi chaque parcours est conçu avec des lecteurs qui ne sont pas à l'AEM, qui exposent les problèmes, décrivent toute théorie nécessaire, puis donnent un aperçu détaillé de la façon dont AEM résout le problème. En raison de la nature exhaustive d’un parcours, il peut s’avérer utile pour les lecteurs qui ne connaissent pas AEM ni les utilisateurs expérimentés.

Un Parcours de documentation standard comporte les parties suivantes.

  • Présentation des objectifs du parcours et de l’audience prévue
  • Description du problème commercial
  • Description de toute théorie nécessaire pour résoudre le problème
  • Conditions préalables et exigences
  • Description de l’audience prévue
  • Etapes de mise en oeuvre

L’objectif d’un Parcours de documentation est de familiariser le lecteur avec les principes de base de la manière dont AEM utilise différentes fonctionnalités et outils pour résoudre un seul problème d’entreprise. Pour cette raison, les étapes de mise en oeuvre illustrent les schémas d’utilisation les plus courants ainsi que les fonctionnalités et options les plus importantes. Des options de paramétrage détaillées sont présentées dans la documentation technique pour une lecture plus approfondie.

Qui doit lire les Parcours de documentation ?

AEM but principal des Parcours de documentation est d’aider les lecteurs qui ne sont pas encore en train d’AEM comprendre combien de fonctionnalités différentes et puissantes du système peuvent être utilisées ensemble pour résoudre les problèmes courants de l’entreprise au moyen d’un récit.

Ainsi, si vous commencez à AEM et que vous souhaitez avoir une analyse de cas spécifique et une vue d’ensemble de la façon dont AEM peut la résoudre, les Parcours de documentation sont les points de départ.

Cependant, il existe de nombreux types d’utilisateurs AEM avec des besoins et des attentes différents. Par exemple :

  • Administrateurs
  • Développeurs
  • Auteurs de contenu
  • Spécialistes de traduction
  • Architectes de contenu

Chaque parcours commence par une déclaration claire de l’audience prévue pour le parcours. Parce que personne ne travaille dans le vide, lorsque le lecteur a besoin de l'aide d'un utilisateur ou d'un personnage système, cela s'explique clairement dans le parcours.

Comment les Parcours de documentation s’insèrent-ils dans la documentation d’AEM ?

Les Parcours de documentation sont destinés à compléter la documentation et les tutoriels techniques AEM existants. Par exemple, un parcours peut vous présenter un concept, puis les documents techniques vous expliquent les options de configuration détaillées dont vous avez besoin et un tutoriel vous guide tout au long de configurations spécifiques.

Type de documentation Objectif Public Présupposés Ombres Type de contenu Longueur
Parcours de documentation Un parcours définit la façon dont AEM peut résoudre un problème commercial général au moyen d’un récit qui guide les lecteurs à travers des processus et fonctionnalités complexes et interconnectés. Il illustre comment plusieurs fonctionnalités fonctionnent ensemble pour répondre aux besoins d’une entreprise selon les bonnes pratiques. Readers nouveaux pour AEM Connaissance générale du CMS Options et configuration détaillées Texte Ca. 1 heure
Documents techniques Les documents techniques se concentrent sur les fonctionnalités individuelles, détaillant le fonctionnement technique de la fonctionnalité et chaque option disponible pour l’utilisateur. Utilisateurs AEM expérimentés AEM expérience Contexte et arrière-plan Texte Variable
Tutoriel Un tutoriel est une présentation détaillée d’un sujet qui montre à un développeur ou à un administrateur comment atteindre un objectif technique (généralement la programmation ou la configuration du système) pas à pas, fournissant des exemples et des exemples de code spécifiques, exploitant généralement un ensemble limité de fonctionnalités. AEM développeurs ou administrateurs AEM expérience Contexte et théorie Vidéo >1 heure
Guide de prise en main Un guide de prise en main est une présentation rapide et éclair d’une nouvelle fonctionnalité d’AEM spécifique. Il s’agit d’un aperçu rapide d’une fonction individuelle, qui guide l’utilisateur à travers les étapes importantes (mais pas toutes) de configuration et d’utilisation d’un cas d’utilisation simple. AEM administrateurs AEM expérience Contexte, théorie et options détaillées Texte <1 heure

Quels Parcours Y A-T-Il ?

Plusieurs Parcours de documentation sont déjà disponibles. Puisque chaque parcours est conçu comme un récit, veuillez commencer par l'introduction et lire tout le long pour avoir une compréhension complète du sujet dans le contexte de l'AEM.

Parcours Description
Parcours de développement découplé Commencez ici pour découvrir comment AEM prend en charge les modèles de développement sans interface et comment lancer votre projet, de la planification à la mise en oeuvre, en passant par la mise en service.
Parcours de création sans affichage Commencez ici pour un parcours guidé à travers les puissantes fonctionnalités et flexibles d’AEM sans interface, leurs fonctionnalités et comment modéliser votre contenu sur votre premier projet sans interface.
Parcours Architecte sans tête Commencez ici pour découvrir les fonctionnalités puissantes, flexibles et sans interface d’Adobe Experience Manager as a Cloud Service et comment modéliser le contenu de votre projet.
Parcours de traduction sans affichage Commencez ici pour découvrir comment configurer et gérer vos projets de traduction sans interface utilisateur graphique dans AEM.
parcours d’intégration AEM Commencez ici pour vous familiariser rapidement avec votre nouvel environnement as a Cloud Service AEM.
parcours de création rapide de site Commencez ici pour obtenir un parcours guidé à travers l’outil de création rapide de site d’AEM simple d’utilisation afin de rationaliser le développement frontal de votre site AEM et de personnaliser rapidement votre site sans aucune connaissance d’ensemble AEM.
parcours Commerce AEM Bientôt !
Parcours de migration AEMaaCS Bientôt !

Revenez pour plus de contenu au fur et à mesure que de nouveaux parcours deviennent disponibles.

Sur cette page