Percorsi di documentazione AEM

Ultimo aggiornamento: 17 aprile 2024
  • Si applica a:
  • Experience Manager 6.5

Creato per:

  • Amministratore
  • Sviluppatore
  • Utente
  • Leader

I Percorsi di documentazione forniscono una struttura narrativa all’interno della documentazione AEM, mediante l’unione di funzioni complesse e disparate per risolvere un obiettivo di business in modo da favorire le 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.