Percorsi di documentazione AEM

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?

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

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

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

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?

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?

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?

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.

Tipo di documentazione Scopo Pubblico Presupposti Omessi Tipo di contenuto Lunghezza
Percorso di documentazione Un percorso definisce come AEM può risolvere un problema aziendale generale attraverso una narrazione che guida i lettori attraverso processi e funzionalità complesse e intercorrelate. Illustra come le diverse funzioni funzionano insieme per risolvere nel modo migliore un’esigenza aziendale. Lettori non esperti di AEM Familiarità generale con un CMS Opzioni e configurazione dettagliate Testo Ca. 1 ora
Documenti tecnici I documenti tecnici si concentrano sulle singole funzioni, descrivendone in dettaglio il funzionamento tecnico e ogni opzione disponibile per l’utente. Utenti AEM esperti Esperienza AEM Contesto e informazioni di base Testo Varie
Tutorial Un tutorial è un approfondimento di un argomento che mostra a uno sviluppatore o un amministratore come raggiungere un obiettivo tecnico (generalmente di programmazione o configurazione del sistema) in modo dettagliato, fornendo esempi specifici e codice di esempio, solitamente sfruttando un set limitato di funzioni. Sviluppatori o amministratori AEM Esperienza AEM Informazioni di base e teoria Video >1 ora
Guida introduttiva Una guida introduttiva è una guida estremamente rapida di una nuova funzione AEM specifica. Offre una panoramica rapida di una singola funzione e guida l’utente attraverso i passaggi importanti (ma non tutti) per configurare e utilizzare un caso d’uso semplice. Amministratori AEM Esperienza AEM Informazioni di base, teoria, opzioni dettagliate Testo <1 ora

Che percorsi ci sono?

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.

Percorso Descrizione
Percorso per sviluppatori headless Inizia qui per vedere come AEM supporta modelli di sviluppo headless e come iniziare il progetto, partendo dalla pianificazione, fino all’implementazione e al Go Live.
Percorso per authoring headless Inizia qui un percorso guidato attraverso le potenti e flessibili funzionalità headless di AEM, le loro caratteristiche e come modellare i contenuti sul tuo primo progetto headless.
Percorso per architetto headless Inizia qui per un’introduzione alle potenti e flessibili funzionalità headless di Adobe Experience Manager as a Cloud Service e per vedere come modellare i contenuti per il tuo progetto.
Percorso di traduzione headless Inizia qui per scoprire come impostare e gestire i tuoi progetti di traduzione headless in AEM.
Percorso di onboarding AEM Inizia qui per cominciare a lavorare rapidamente con il tuo nuovo ambiente AEM as a Cloud Service.
Percorso di creazione di siti rapidi AEM Inizia qui per un percorso guidato attraverso lo strumento di creazione rapida del sito AEM per semplificare lo sviluppo front-end del sito AEM e personalizzare rapidamente il sito senza alcuna conoscenza del back-end di AEM.
Percorso Commerce AEM In arrivo.
Percorso di migrazione ad AEM as a Cloud Service Inizia qui per un percorso passo passo su come migrare dall’installazione di AEM on-premise o gestito da Adobe ad AEM as a Cloud Service completamente basato sul cloud e approfittare dei numerosi vantaggi che ne derivano.

Torna a controllare i nuovi contenuti, man mano che sono disponibili nuovi percorsi.

In questa pagina