AEM dokumentationsresor

Dokumentation Journeys innehåller en berättande struktur i AEM dokumentation genom att sammanfoga komplexa och olika funktioner för att lösa ett affärsmål på ett sätt som är beprövat med bästa praxis. Resorna är utformade med AEM nybörjare i åtanke och presenterar koncept och funktioner för att uppnå ett mål från A till Ö.

Vad är en dokumentationsresa?

En dokumentationsresa knyter ihop många olika och komplexa ämnen och funktioner genom att tillhandahålla en berättelse som hjälper läsaren, som kan vara ny på att AEM, förstå och lösa ett affärsproblem från början till slut, samtidigt som man antar minimala tidigare ämnesområden eller AEM kunskaper.

Dokumentation Resor står i kontrast till AEM befintliga tekniska dokument som primärt fokuserar på en enda funktion och dokumentation av uppgifter, och som förutsätter att man är bekant med AEM. Genom att fokusera på koncepten och ge detaljerad information till den befintliga tekniska dokumentationen ger Documentation Journeys läsarna nya möjligheter att AEM en plats där de kan börja förstå hur plattformen kan utnyttjas genom att använda bästa praxis för att hantera vanliga affärsbehov och arbetsflöden. Av den anledningen fungerar Documentation Journeys som ett komplement till och inte som ersättning för AEM befintlig teknisk dokumentation.

Learning by Narrative

AEM har en omfattande och kraftfull funktionsuppsättning som kan vara överväldigande för nya (och ibland erfarna) användare. Genom att inleda varje resa med ett tydligt affärsmål i stället för tekniska krav visar en resa en berättande vägledning som leder läsaren genom de AEM koncept och funktioner som fungerar tillsammans för att uppnå verksamhetsmålet.

Genom att berätta en historia förstår läsaren bättre hur olika delar av AEM fungerar tillsammans för att lösa det aktuella problemet och perspektivet bibehålls. Läsaren kan alltså se vilken affärsmålskog som finns för funktionsträden.

Fokusera på koncept, inte funktioner

För att fokusera på berättandet betonar Documentation Journeys koncept i AEM istället för att satsa på tekniska funktioner. Eftersom läsaren vet att det är viktigare att han/hon känner till hur AEM löser ett visst problem i stället för att oroa sig för vilka kryssrutor han ska klicka på, fortsätter läsaren genom berättelsen och visar hur man länkar samman flera viktiga koncept för att uppnå det övergripande målet.

Resorna ser till att läsaren vet hur AEM kan lösa ett problem i stället för att behöva bekymra sig om varje alternativ som du klickar på. Om läsaren vill fördjupa sig och lära sig mer teknisk information eller vilka ytterligare alternativ som kan göra, länkar varje del av resan till relaterad, uttömmande teknisk dokumentation.

Orientering för bästa praxis

Dokumentationsresor har utformats utifrån principer för god praxis, som bygger på Adobe senaste forskning, dokumenterad implementeringserfarenhet från Adobes tjänster och feedback från kundprojekt.

Om du vill veta hur Adobe rekommenderar att du löser ett affärsärende med AEM, så är Documentation Journeys där du ska börja.

Hur är en dokumentationsresa strukturerad?

En dokumentationsresa fungerar som en introduktion till hur AEM löser vanliga affärsproblem. Därför är varje resa utformad med läsare som inte har AEM i åtanke, som utformar affärsproblemet, beskriver en nödvändig teori och sedan ger en stegvis översikt över hur AEM löser problemet. Eftersom en resa är omfattande kan den vara användbar både för läsare som är nya för AEM och för erfarna användare.

En typisk dokumentationsresa har följande delar.

• Översikt över målen för resan och den avsedda målgruppen
• Beskrivning av affärsproblem
• Beskrivning av en teori som är nödvändig för att lösa problemet
• Krav och krav
• Beskrivning av avsedd målgrupp
• Implementeringssteg

Målet med en dokumentationsresa är att bekanta läsaren med grunderna i hur AEM använder olika funktioner och verktyg för att lösa ett enda affärsproblem. Därför illustrerar implementeringsstegen de vanligaste användningsmönstren och de viktigaste funktionerna och alternativen. Detaljerade konfigurationsalternativ finns länkade till i den tekniska dokumentationen för ytterligare läsning.

Vem ska läsa dokumentationsresor?

AEM dokumentation Journeys främsta mål är att hjälpa läsare som inte är AEM förstå hur många olika och kraftfulla funktioner i systemet som kan användas tillsammans för att lösa vanliga affärsproblem genom en berättelse.

Så om du inte är van vid att AEM och har ett specifikt affärsfall i åtanke och vill ha en översikt över hur AEM kan lösa det är Documentation Journeys där du vill börja.

Det finns dock många olika typer av AEM användare med olika behov och förväntningar. Till exempel:

• Administratörer
• Utvecklare
• Innehållsförfattare
• Översättningsspecialister
• Innehållsarkitekter

Varje resa börjar med en tydlig beskrivning av den avsedda målgruppen för resan. Eftersom ingen arbetar i ett vakuum, när läsaren kräver hjälp av indata från en systemanvändare eller persona, förklaras detta tydligt under resan.

Hur passar Document Journeys in i AEM?

Dokumentationsresor är avsedda som komplement till befintlig AEM teknisk dokumentation och självstudiekurser. En resa kan t.ex. ge dig en idé, och sedan förklarar de tekniska dokumenten de detaljerade konfigurationsalternativ du kan behöva och en självstudiekurs som hjälper dig igenom specifika inställningar.

Vilka resor finns det?

Det finns redan ett antal dokumentationsresor tillgängliga för dig. Eftersom varje resa är utformad som en berättelse, var vänlig och börja med inledningen och läs igenom hela vägen för att få en fullständig förståelse för ämnet i AEM.

Resurser för Business.Adobe.com