Percorsi di documentazione AEM aem-documentation-journeys
I Percorsi di documentazione forniscono una struttura narrativa all’interno della documentazione AEM, mediante l’unione di funzioni complesse e disparate al fine di risolvere un obiettivo di business in modo da costituire una best practice. Progettati pensando agli inesperti di AEM, i percorsi introducono i concetti e le funzionalità che consentono di raggiungere un obiettivo da A a Z.
Cos’è un Percorso di documentazione? what-is
Un percorso di documentazione unisce molti argomenti e caratteristiche diversi e complessi, fornendo un resoconto che aiuta il lettore, che potrebbe essere un nuovo utente di AEM, a capire e risolvere un problema di business dall’inizio alla fine, supponendo una conoscenza minima pregressa dell’argomento o di AEM.
I Percorsi di documentazione sono molto diversi dai documenti tecnici AEM esistenti, che si concentrano principalmente su un’unica funzione e documentazione delle attività, supponendo la conoscenza di AEM. Concentrandosi sui concetti e rinviando i dettagli approfonditi alla documentazione tecnica esistente, i Percorsi di documentazione offrono ai lettori che non conoscono AEM un punto da cui iniziare a comprendere come sfruttare la piattaforma utilizzando le best practice per rispondere a esigenze e flussi di lavoro di business comuni. Per questo motivo, i Percorsi di documentazione fungono da complemento e non da sostituzione della Documentazione tecnica AEM esistente.
Apprendimento per narrazione narrative
AEM dispone di un set di funzioni ricche e potenti che rischiano di sopraffare i nuovi utenti (e a volte anche gli esperti). Iniziando con un obiettivo di business chiaro, invece che con requisiti tecnici, ogni percorso racconta una storia che guida il lettore attraverso i concetti e le funzionalità AEM e la relativa collaborazione per raggiungere l’obiettivo di business.
Raccontando una storia, il lettore capisce meglio come diverse parti di AEM lavorano insieme per risolvere il problema che si trova davanti e la prospettiva viene mantenuta. Così il lettore può vedere la foresta obiettivo di business per gli alberi di caratteristiche.
Focus su Concetti e non su Funzioni concepts
Per mantenere l’attenzione sulla narrazione, i Percorsi di documentazione in AEM evidenziano i concetti invece di approfondire le caratteristiche tecniche. Riconoscendo che è più importante che il lettore abbia familiarità con la modalità in cui AEM risolve un particolare problema, invece di preoccuparsi delle caselle di controllo su cui fare clic, il percorso fa procedere il lettore attraverso la narrazione, illustrando come collegare più concetti importanti in modo da raggiungere l’obiettivo generale.
I percorsi garantiscono che il lettore sappia come AEM risolve un problema senza preoccuparsi di ogni opzione su cui fare clic. Per il lettore che desidera approfondire l’analisi e apprendere dettagli tecnici o eventuali opzioni aggiuntive, ogni parte del percorso si collega alla relativa documentazione tecnica esaustiva.
Orientamento alle best practice best-practices
I percorsi di documentazione sono progettati in base ai principi delle best practice, costruite grazie alle ultime ricerche condotte da Adobe, alla comprovata esperienza nell’implementazione da parte dei servizi Adobe e al feedback raccolto sui progetti dei clienti.
Se desideri sapere come Adobe consiglia di risolvere un caso di business con AEM, i Percorsi AEM sono il posto giusto da cui cominciare.
Come è strutturato un Percorso di documentazione? structure
Un Percorso di documentazione funge da introduzione, basata sulle best practice, alla modalità in cui AEM risolve problemi di business comuni. Per questo motivo, ogni percorso è progettato pensando ai nuovi utenti di AEM, con una descrizione del problema di business e di ogni teoria necessaria, e infine con una panoramica dettagliata di come AEM risolve il problema. A causa della natura completa dei percorsi, questi possono essere utili sia per i lettori che non hanno esperienza di AEM che per gli utenti esperti.
Un tipico Percorso di documentazione include le parti seguenti.
- Panoramica degli obiettivi del percorso e del pubblico previsto
- Descrizione del problema di business
- Descrizione di ogni teoria necessaria per risolvere il problema
- Prerequisiti e requisiti
- Descrizione del pubblico previsto
- Passaggi di implementazione
Un obiettivo del Percorso di documentazione è quello di rendere familiari al lettore le nozioni di base su come AEM utilizza funzioni e strumenti diversi per risolvere un singolo problema di business. Per questo motivo, i passaggi di implementazione illustrano i pattern di utilizzo più comuni e le funzioni e opzioni più importanti. Per ulteriori informazioni, nella documentazione tecnica sono presenti collegamenti alle opzioni di configurazione dettagliate.
Chi dovrebbe leggere i percorsi di documentazione? who
L’obiettivo principale dei Percorsi di documentazione AEM è quello di aiutare, attraverso una narrazione, i lettori che non hanno esperienza di AEM a capire quante funzioni diverse e potenti del sistema possono essere utilizzate insieme per risolvere problemi di business comuni.
Quindi, se sei un nuovo utente di AEM con in mente un caso di business specifico e desideri una panoramica di come AEM può risolverlo, i Percorsi di documentazione sono il punto giusto da cui iniziare.
Tuttavia esistono molti tipi diversi di utenti AEM con esigenze e aspettative diverse. Esempio:
- Amministratori
- Sviluppatori
- Autori di contenuti
- Specialisti della traduzione
- Architetti dei contenuti
Ogni percorso inizia con una chiara definizione del pubblico previsto per il percorso. Poiché nessuno lavora completamente isolato, quando il lettore ha bisogno dell’aiuto di un input da parte di un utente di sistema o utente tipo, questo è chiaramente spiegato all’interno del percorso.
Come si adattano i Percorsi di documentazione alla documentazione AEM? compare
I Percorsi di documentazione sono intesi come complemento alla documentazione tecnica e ai tutorial AEM esistenti. Ad esempio, un percorso potrebbe presentare un concetto, i documenti tecnici potrebbero illustrare le opzioni di configurazione dettagliate che potrebbero essere necessarie e un tutorial potrebbe guidare attraverso configurazioni specifiche.
Che percorsi ci sono? journeys
Sono già disponibili diversi Percorsi di documentazione. Poiché ogni percorso è progettato in modalità narrativa, consigliamo di iniziare con l’introduzione e leggere tutto il percorso per ottenere una piena comprensione dell’argomento nel contesto di AEM.
Torna a controllare i nuovi contenuti, man mano che sono disponibili nuovi percorsi.