Medewerkershandleiding voor Adobe-documentatie
In deze handleiding wordt beschreven hoe u een bijdrage kunt leveren aan de Adobe Enterprise Help op het Experience League.
Wat is samenwerkingsdocumentatie?
De technische documentatie en enablement inhoud voor Adobe Experience Cloud en andere producten van de Onderneming van Adobe zijn gebaseerd op open bronprincipes die de oplossingen GitHub, Markdown, en van Adobe Experience Cloud gebruiken.
Dit open-sourcemodel verbetert de kwaliteit van de inhoud en de communicatie tussen klanten, documentatieteams en productteams. Op elke pagina kunt u nu het nut van inhoud beoordelen, problemen met het logbestand bekijken en zelfs inhoudssuggesties leveren als Git pull-aanvragen (PR's). De documentatieteams van de Adobe houden dagelijks toezicht op de bijdragen en problemen en voeren zo nodig updates, bijstellingen en aanpassingen uit.
Werken met documentatie voor samenwerken
Als gebruiker van dit materiaal - ongeacht als u een werknemer, een partner, een klant of zelfs potentiële klanten bent - hebt u de keus om aan deze documentatie op verscheidene eenvoudige manieren bij te dragen.
- De vraag of de pagina nuttig ❶ en een optionele opmerking ❷
- Een probleem rapporteren op een specifieke pagina (vereist aanmelding bij it) ❸
- Plaats een snelle bewerking voor het ontwerpen van gehele artikelen, compleet met elementen en codevoorbeelden (hiervoor is Git-aanmelding vereist) ❹
Deze opties worden een paar seconden na het openen onder aan de pagina weergegeven. Als u het feedbackgebied sluit, kunt u de pagina opnieuw laden om deze terug te halen.
In deze handleiding wordt alles beschreven wat u moet weten om te communiceren met en bij te dragen aan deze materiaalset.
De bruikbaarheid van de pagina beoordelen en een opmerking schrijven
Een paar seconden nadat u een pagina hebt geopend, wordt onder aan de pagina een feedbackgebied weergegeven. Klik omhoog of omlaag om aan te geven of de pagina nuttig was.
Voel u vrij om een opmerking te geven voor extra feedback.
Snelle bewerkingen uitvoeren op bestaande documenten
Als u gedetailleerdere feedback wilt geven, kunt u met behulp van snelle bewerkingen kleine fouten en weglatingen in documenten corrigeren. Wanneer u een bewerking voorstelt, verzendt u een pull-verzoek (PR) om de correctie/suggestie naar ons te verzenden en kunnen we de suggestie doorlichten, goedkeuren en publiceren.
-
Onderteken de Licentieovereenkomst voor contribuanten (CLA) indien aanvaardbaar.
U hoeft slechts één keer een Adobe CLA in te dienen.
-
Klik in het feedbackgebied onder aan het artikel op Detailed feedback options en klik vervolgens op Suggest an edit om naar het markdown brondossier op GitHub te gaan.
-
Klik op het potloodpictogram om het artikel te bewerken.
note note NOTE Als het potloodpictogram grijs uit is, moet u login aan uw rekening GitHub, of een nieuwe rekening tot stand brengen. 
-
Breng de gewenste wijzigingen aan in de webeditor.
U kunt op de knop Preview changes om de opmaak van de wijziging te controleren.
-
Blader naar de onderkant van de pagina nadat u de wijzigingen hebt aangebracht.
Voer een titel en beschrijving in voor uw PR en klik vervolgens op Propose file change zoals weergegeven in de volgende afbeelding:
note note NOTE Als u een foutbericht krijgt over het ondertekenen van een licentieovereenkomst voor contribuanten (CLA), klikt u op Details de licentieovereenkomst te openen. Onderteken de overeenkomst, indien acceptabel. Vervolgens sluit u het verzoek en opent u het verzoek en gaat u verder.
Dat is alles wat er aan te pas komt. De leden van het documentatieteam zullen uw trekkrachtverzoek herzien en samenvoegen. Bedankt!
Een probleem melden
Een andere gemakkelijke manier om ons op de hoogte te brengen van een probleem met een stuk inhoud is gebruik te maken Report an issue.
-
Klik in het feedbackgebied onder aan het artikel op Detailed feedback options en klik vervolgens op Report an issue om naar het markdown brondossier op GitHub te gaan.
note note NOTE Om een kwestie te melden, moet u login aan uw rekening GitHub, of een rekening creëren. Als u op deze koppeling klikt, kunt u een snel ticket aanmelden bij het Experience League via de interface voor Github Issue.
De URL van de pagina met de uitgave wordt automatisch ingevuld in het beschrijvingsveld.
-
Vul de titel in, schrijf een korte beschrijving van de kwestie, en klik dan Nieuwe uitgave verzenden.
Als u een uitgave verzendt, wordt het inhoudsteam op de hoogte gebracht van deze pagina, die uw probleem kan verhelpen. Als we de inhoud hebben bijgewerkt, geven we dit via de interface Github Issues door en sturen we u een e-mail wanneer deze wordt bijgewerkt of gesloten.
GitHub-machtigingen begrijpen
De GitHub die UI uitgeeft past aan uw bewaarplaatstoestemmingen aan. De voorgaande afbeeldingen zijn accuraat voor contribuanten die geen schrijfmachtigingen hebben voor de doelopslagplaats. GitHub leidt automatisch tot een vork van de doelbewaarplaats in uw rekening. Als u toegang tot de doelbewaarplaats hebt schrijven, leidt GitHub tot een nieuwe tak in de doelrepo.
Adobe gebruikt trekkingsverzoeken voor alle veranderingen, zelfs voor contribuanten die schrijftoegang hebben. De meeste opslagplaatsen hebben de main vertakking beveiligd zodat updates moeten worden ingediend als pull-aanvragen.
De bewerkervaring in de browser is het meest geschikt voor kleine of niet-frequente wijzigingen. Als u een grote bijdrage levert of geavanceerde Git-functies gebruikt, raden we u aan forceer de repo en werk lokaal.
Feedback geven
Met een oplossing die zo groot als Adobe wordt geplaatst, is de documentatie altijd een werk lopend. Als u fouten ontdekt, registreer een kwestie, als u suggesties op materiaal hebt te vertellen gelieve ons. Vertel ons welke informatie u zocht. Laat ons weten of u niet kon vinden wat u nodig had, of als u moeite had om uw taak te voltooien, gelieve ons te vertellen hoe wij u kunnen helpen onze oplossingen leren.
Dank van het Collaborative Documentation team en alle schrijvers en inhoudsproducenten in Experience League.