source-git-commit	workflow-type	source-wordcount	ht-degree
580a15c908fc8ac4ef5d62582dfdd87d75dde994	tm+mt	766	3%

Technische documentatie van Adobe Commerce

Wij verwelkomen de bijdragen van onze gemeenschap en van Adobe werknemers van buiten de documentatieteams.

Adobe Open Source Code of Conduct

Dit project heeft de Adobe-gedragscode voor open source of de .NET Foundation-gedragscode overgenomen. Zie het artikel Bijdragen voor meer informatie.

Over uw bijdragen aan Adobe-inhoud

Zie de Handleiding Adobe Docs Contributor.

Hoe u een bijdrage levert, hangt af van wie u bent en van het soort veranderingen dat u wilt bijdragen:

Kleine wijzigingen

Als u kleine updates wilt toevoegen, gaat u naar het artikel en klikt u op het feedbackgebied onder aan het artikel. Klik op Gedetailleerde feedbackopties en klik vervolgens op Een bewerking voorstellen om naar het markdown brondossier op GitHub te gaan. Gebruik GitHub UI om uw updates te maken. Zie het algemene gedeelte Handleiding Adobe Docs-contributor voor meer informatie .

Kleine correcties of verduidelijkingen die u ter documentatie en codevoorbeelden in dit antwoord aanbrengt, vallen onder de gebruiksvoorwaarden van de Adobe.

Belangrijke wijzigingen of nieuwe artikelen van leden van de gemeenschap

Als u deel uitmaakt van de gemeenschap van de Adobe en u een nieuw artikel wilt creëren of belangrijke veranderingen voorleggen, gelieve het lusje van Kwesties in de bewaarplaats van de it te gebruiken om een kwestie voor te leggen om een gesprek met het documentatieteam te beginnen. Zodra u met een plan hebt ingestemd, zult u met een werknemer moeten werken helpen die nieuwe inhoud door een combinatie van het werk in de openbare en privé bewaarplaatsen brengen.

Belangrijkste veranderingen ten opzichte van Adobe werknemers

Als u een technisch schrijver, programmamanager, of ontwikkelaar van het productteam voor een oplossing van Adobe Experience Cloud bent en het uw baan is om aan of auteur technische artikelen bij te dragen, zou u de privé bewaarplaats op moeten gebruiken https://git.corp.adobe.com/AdobeDocs.

Gereedschappen en instellen

Communautaire contribuanten kunnen GitHub UI voor basishet uitgeven of vork gebruiken het repo om belangrijke bijdragen te leveren.

Zie de Handleiding Adobe Docs Contributor voor meer informatie.

Hoe te om prijsdaling te gebruiken om uw onderwerp te formatteren

Alle artikelen in deze repository gebruiken GitHub gearomatiseerde prijsopgave. Als u niet vertrouwd bent met markering, zie:

• Grondbeginselen van markeringen
• Afdrukbare opmaakmodel

Sjablonen

Voor sommige onderwerpen, gebruiken wij gegevensdossiers en malplaatjes om gepubliceerde inhoud te produceren. De gevallen van het gebruik voor deze benadering omvatten:

• Grote sets met programmatisch gegenereerde inhoud publiceren
• Het verstrekken van één enkele bron van waarheid voor klanten over veelvoudige systemen die machine-leesbare dossierformaten, zoals YAML, voor integratie vereisen (b.v., het Hulpmiddel van de Analyse van de Plaats-Brede)

Voorbeelden van sjablooninhoud zijn onder andere:

• CLI-gereedschapsverwijzing
• Beschikbaarstellingstabellen voor producten
• Tabellen met systeemvereisten

Sjablooninhoud genereren

In het algemeen, moeten de meeste schrijvers slechts een versieversie aan de de productbeschikbaarheid en lijsten van de systeemvereisten toevoegen. Het onderhoud voor alle andere sjablooninhoud wordt automatisch of beheerd door een toegewezen teamlid. Deze instructies zijn bedoeld voor de meeste schrijvers.

OPMERKING:

• Voor het genereren van gesjabloonde inhoud moet u op de opdrachtregel in een terminal werken.
• Ruby moet zijn geïnstalleerd om het renderscript uit te voeren. Zie _jekyll/.ruby-version voor de vereiste versie.

Zie het volgende voor een beschrijving van de bestandsstructuur voor sjablooninhoud:

• _jekyll—Bevat sjablonen voor onderwerpen en vereiste elementen
• _jekyll/_data—Bevat de machineleesbare bestandsindelingen die worden gebruikt om sjablonen te renderen
• _jekyll/templated—Bevat op HTML gebaseerde sjabloonbestanden die de taal voor vloeiende sjablonen gebruiken
• help/_includes/templated—Bevat de gegenereerde uitvoer voor sjablooninhoud in .md bestandsindeling zodat deze kan worden gepubliceerd in onderwerpen over Experiencen League; het renderscript schrijft automatisch gegenereerde uitvoer naar deze map voor u

Sjablooninhoud bijwerken:

1. Open in de teksteditor een gegevensbestand in het dialoogvenster /jekyll/_data directory. Bijvoorbeeld:

   • Beschikbaarstellingstabellen voor producten: /jekyll/_data/product-availability.yml
   • Tabellen met systeemvereisten: /jekyll/_data/system-requirements.yml

2. Gebruik de bestaande YAML-structuur om items te maken.

   Als u bijvoorbeeld een versie van Adobe Commerce wilt toevoegen aan de tabellen voor productbeschikbaarheid, voegt u het volgende toe aan elk item in het dialoogvenster extensions en services van de /jekyll/_data/product-availability.yml bestand (wijzig zo nodig versienummers):

   support:
      - core: 1.2.3
        version: 4.5.6
   

3. Ga naar de _jekyll directory.

   cd _jekyll
   

4. Genereer sjablooninhoud en schrijf de uitvoer naar de help/_includes/templated directory.

   rake render
   

   OPMERKING: U moet het script uitvoeren vanuit het dialoogvenster _jekyll directory. Als dit uw eerste keer is om het manuscript in werking te stellen, moet u de gebiedsdelen van Ruby eerst met installeren bundle install gebruiken.

5. Controleren of de verwachte help/_includes/templated bestanden zijn gewijzigd.

   git status
   

   U zou output gelijkend op het volgende moeten zien:

   modified:   _data/product-availability.yml
   modified:   ../help/_includes/templated/product-availability-extensions.md
   

Raadpleeg de documentatie bij Jekyll voor meer informatie over Gegevensbestanden, Vloeibare filtersen andere functies.