source-git-commit	workflow-type	source-wordcount	ht-degree
a6086afc0a1f099b62014ad61098a5a1dc9d4675	tm+mt	719	3%

Technische documentatie van Adobe Commerce

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

Adobe Open gedragscode van Source

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 Gids van de Medewerker van Docs van de Adobe .

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

Kleine wijzigingen

Als u minder belangrijke updates bijdraagt, bezoek het artikel en klik het terugkoppelen gebied dat bij de bodem van het artikel verschijnt, klik Gedetailleerde terugkoppelt opties, en klik dan Voorstellen en uitgeven om naar het prijsonderdrukkingsbrondossier op GitHub te gaan. Gebruik GitHub UI om uw updates te maken. Zie de algemene de bijdragegids van Docs van de Adobe 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 bij https://git.corp.adobe.com/AdobeDocs moeten gebruiken.

Gereedschappen en instellen

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

Zie de Gids van de Medewerker van Docs van de Adobe voor details.

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 de Prijsverlaging
• Afdrukbare prijsdaling

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 hulpmiddelverwijzing
• de beschikbaarheidstabellen van het Product
• de lijsten van de 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.

NOTA:

• 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 Experiencen League-onderwerpen; het renderscript schrijft automatisch gegenereerde uitvoer naar deze map voor u

Sjablooninhoud bijwerken:

1. Open een gegevensbestand in de map /jekyll/_data in de teksteditor. Bijvoorbeeld:

   • de beschikbaarheidstabellen van het Product : /jekyll/_data/product-availability.yml
   • Eisen van het Systeem lijsten : /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 elke vermelding in de secties extensions en services van het bestand /jekyll/_data/product-availability.yml (wijzig zo nodig de versienummers):

   support:
      - core: 1.2.3
        version: 4.5.6
   

3. Navigeer naar de map _jekyll .

   cd _jekyll
   

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

   rake render
   

   NOTA: u moet het manuscript van de _jekyll folder in werking stellen. Als dit de eerste keer is om het script uit te voeren, moet u Ruby-afhankelijkheden eerst installeren met de opdracht bundle install .

5. Navigeer terug naar de map root .

   cd ..
   

6. Controleer 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
   

7. Druk op de wijzigingen.

   git add .
   git commit -m "descriptive message of the intended commit"
   git push
   

Zie de documentatie van Jekyll voor meer details over Dossiers van Gegevens , Vloeiende filters , en andere eigenschappen.