Aanbevolen werkwijzen ontwerpen
Overzicht overview
Deze pagina beschrijft regels die u zou moeten volgen wanneer creërend uw pagina van de bestemmingsdocumentatie , om ervoor te zorgen dat het aan de Adobe Experience Platform normen van de documentatiekwaliteit voldoet.
Algemene richtsnoeren general-guidance
- Wanneer het invullen van het malplaatje voor uw bestemmingsdocumentatie, verwijs naar de de bijdragegids van Adobe voor informatie over het verbinden , lijsten , de gesteunde prijsdalingssyntaxis , het schrijven van begeleiding , en meer.
- Plaats geen opmerkingen en schattingen in de productdocumentatie.
- In de documentatie van Experience Platform, gebruiken de schrijvers van Adobe gewaagde het formatteren om naar gebruikersinterfacecontroles, als dit te verwijzen:
- Ga naar Connections > Destinations en selecteer de tab Catalog . Bekijk een voorbeeld van hoe de controles van het gebruikersinterface in a bestemmingsleerprogramma worden gedocumenteerd.
Schrijfstijl writing-style
- Houd je zinnen kort en kom snel op. Als uw zin langer is dan 20 woorden of meerdere komma's gebruikt, kunt u het opsplitsen in aparte zinnen. Zinnen van meer dan 20 woorden kunnen vooral lastig zijn voor lezers.
- Wees niet al te beleefd. Vermijd het gebruik van "alstublieft" of "vriendelijk …" in technische documentatie.
Koppelen linking
Volg de meegeleverde documentatiesjabloon en bewerk de bestaande koppelingen in de sjabloon niet. Wanneer het omvatten van nieuwe verbindingen, lees gebruikend verbindingen in documentatie in de bijdragegids.
Richtlijnen voor branding branding
-
AEP is geen algemeen aanvaarde term. Gebruik Adobe Experience Platform voor het eerste gebruik, daarna Experience Platform en vervolgens Experience Platform.
- gebruik niet: Alvorens u gegevens van AEP naar YourDestination kunt uitvoeren, zorg ervoor u leest en deze eerste vereisten voltooit.
- Gebruik: Alvorens u gegevens van Adobe Experience Platform naar YourDestination kunt uitvoeren, zorg ervoor u leest en deze eerste vereisten voltooit.
Afbeeldingen en screenshots images-and-screenshots
-
Voor informatie over hoe te om aan beelden te verbinden, verwijs naar de bijdragegids.
-
Wanneer u schermafbeeldingen gebruikt, moet u ervoor zorgen dat uw schermafbeelding het volledige scherm van de gebruikersinterface van Experience Platform vastlegt.
-
Wanneer u afbeeldingen markeert om een bepaald besturingselement of label op de pagina te markeren, probeert u de markeringsstijl te volgen die wordt gebruikt door het Experience Platform-documentatieteam. Bericht hoe op profiel-gebaseerd in dit schermafbeelding wordt benadrukt.
-
Gebruik afbeeldingen in de
png-indeling. -
Gebruik geen genummerde schermafbeeldingen als bestandsnamen. Namen van afbeeldingsbestanden moeten beschrijvend zijn.
- gebruikt niet:
1.png,2.png,3.png - Gebruik:
yourdestination-authentication-details.png,yourdestination-destination-details.png
- gebruikt niet:
-
Gebruik alt-tekst voor alle afbeeldingen die u aan de documentatie toevoegt en gebruik de juiste grammatica in de alt-tekst.
- gebruikt niet: De details van de bestemmingsverbinding
- Gebruik: Beeld van Experience Platform UI, tonend de details van de bestemmingsverbinding die in worden gevuld.
Proces process
- Het documentatiemalplaatje wordt bijgewerkt niet vaak, gebaseerd op partner terugkoppelt. Alvorens u met het ontwerpen van documentatie voor uw bestemming begint, zorg ervoor dat u de recentste versie van het malplaatje hebt gedownload.
- Auteur de documentatie en creeer het verzoek van de documentatietrek (PR) van een tak in uw vork buiten de belangrijkste tak. Verwijs naar voorlegt bestemming voor overzichtssectie wanneer het ontwerpen in de interface GitHub of in uw lokaal milieu .