Ondersteuning voor op maat gemaakte methodologieën

Configuratie van op maat gemaakte handmatige testmethodologie in Axe Auditor

Doel

Klanten die axe Auditor gebruiken, moeten soms de handmatige testmethodologie aanpassen (de DequeWay). Deze behoefte kan ontstaan uit:

• Specifieke interne beleidsregels die extra of minder controles vereisen.
• Interne richtlijnen voor het gebruik van specifieke tools bij het uitvoeren van tests.
• Beleidsbeslissingen die verschillende attribuutkenmerken (impact, beschrijvingen, aanbevelingen) wijzigen.

Dit document beschrijft de aanpassingen die kunnen worden gemaakt aan de handmatige testmethodologie in axe Auditor, en legt uit hoe deze wijzigingen terugvloeien naar Deque voor verpakking en inzet naar uw gehoste instance.

Hoe Dit Werkt: Rollen en Workflow

De axe Auditor-instance van uw organisatie wordt gehost en beheerd door Deque. Dat betekent dat Deque zorgt voor de installatie, versievolgorde, verpakking en inzet van de methodologie. Uw team is alleen verantwoordelijk voor het bewerken van de configuratiebestanden van de methodologie. U hoeft geen versienummers bij te werken, pakketten te bouwen of installatie- of databasecommando's uit te voeren. Deque regelt dit allemaal namens u.

Het end-to-end proces is:

Reikwijdteopmerking: Dit document vermeldt alle beschikbare aanpassingstypen voor volledigheid. De specifieke wijzigingen die uw team zal maken, moeten overeenkomen met de overeengekomen veranderingsomvang.

Voordat U Begint

1. Maak een back-up van het origineel. Voordat u iets bewerkt, maakt u een kopie van de uitgepakte package map. Als een wijziging de bundel breekt, is dit uw enige schone manier om te herstellen.

cp -r package package_backup_original

2. Bewerk alleen de bestanden die in elk gedeelte worden vermeld. De bestanden zijn onderling afhankelijk. Het bewerken van een bestand dat niet vermeld is voor een bepaalde wijziging — of het missen van een dat is vermeld is — kan een bundel opleveren die alleen mislukt nadat deze terug en weer ouderwetseurde manier teruggaat naar Deque.

3. Valideer elk bestand dat je aanraakt. Elk bestand is JSON en moet na bewerking geldig JSON blijven (geen komma's aan het einde, gebalanceerde accolades/haken). Valideer voordat je verzendt:

# Validate a single file
python3 -m json.tool package/dist/bundle/descriptions.json > /dev/null && echo "VALID" || echo "INVALID"

# Or validate every JSON file in the bundle at once
find package/dist -name "*.json" -print0 | while IFS= read -r -d '' f; do
  python3 -m json.tool "$f" > /dev/null 2>&1 && echo "VALID:   $f" || echo "INVALID: $f"
done

4. Taalaanname. Deze instructies gaan uit van Engels (en). Als je organisatie methodiek in andere talen vereist, laat het aan Deque weten — Deque biedt tijdens configuratie taalondersteuning. In dat geval moet elke wijziging die je in een .en.json bestand aanbrengt, ook in het overeenkomstige lokale bestand worden aangebracht (bijvoorbeeld het .nl.json equivalent) voor elke extra taal.

Toegestane Updates

Werk de testmethodologie bij voor een specifiek controlepunt

Handig wanneer je de testinstructies voor een specifiek controlepunt in axe Auditor wilt wijzigen.

Bijgewerkte bestanden: package/dist/bundle/locales/checkpoints.en.json

Stappen:

1. Zoek het specifieke Deque-controlepunt in het JSON-bestand (bijv. 1.1.1.a).
2. Zoek het testing-methodology attribuut onder dat specifieke controlepunt.
3. Breng de juiste updates aan voor elk type asset dat onder testing-methodology is vermeld.
4. Sla het bestand op op zijn huidige locatie.

Opmerking: De naam van het controlepunt dat zichtbaar is in axe Auditor kan ook worden gewijzigd met dezelfde instructies. In plaats van testing-methodology sectie bij te werken, werk je het name attribuut bij onder het relevante controlepunt in hetzelfde bestand.

Pas de Impact van een Regel aan

Je kunt het impactniveau (blocker, cruciaal, ernstig, matig, klein) voor elk probleem binnen axe Auditor wijzigen. Als je echter het standaard impact voor een regel moet wijzigen, volg dan deze instructies.

Impacts in axe Auditor worden opgeslagen op het regel niveau, niet op het niveau van een WCAG-succescriterium of controlepunt. Een enkele regel kan invloed hebben op meerdere Deque-controlepunten (bijv. regel-id alt-text-dynamic-image-inconsistent). Het wijzigen van de impact van de regel verandert de standaardimpact voor een probleem dat wordt veroorzaakt door de schending van deze regel voor alle allemaal WCAG-succescriteria die aan de regel zijn gekoppeld.

Bijgewerkte bestanden: package/dist/bundle/descriptions.json

Stappen:

1. Zoek de specifieke Deque-regel in het JSON-bestand (bijv. alt-text-dynamic-image-inconsistent).
2. Zoek het impact attribuut onder die specifieke regel.
3. Werk de impact bij met een numerieke waarde (zie de onderstaande tabel).
4. Sla het bestand op op zijn huidige locatie.

Impactwaardetoewijzingen

Voeg een Nieuwe Toegankelijkheidsstandaard toe (bijv. een Organisatie-Specifieke Standaard)

Als je organisatie-specifieke teststandaarden hebt die je naast de bestaande standaarden (zoals WCAG 2.1 AA of ACAA) aan je teams wilt voorleggen, volg dan de volgende stappen.

⚠️ Deque intern — los op voordat je publiceert: De bestandenlijst voor deze sectie verwijst naar drie controlepuntgerelateerde paden die niet consistent zijn met de rest van het document (dat gebruikt dist/bundle/…): package/dist/checkpoints.json, package/dist/issue-descriptions.json, en package/dist/bundle/checkpoints.json. Bevestig of dist/checkpoints.json en dist/issue-descriptions.json werkelijk aparte gecompileerde bestanden zijn, of dat dit padfouten zijn, en werk de lijst dienovereenkomstig bij en verwijder deze opmerking.

Bijgewerkte bestanden:

• package/dist/bundle/standards.json
• package/dist/bundle/descriptions.json
• package/dist/bundle/testingMethodologies.json
• package/dist/bundle/locales/standards.en.json
• package/dist/checkpoints.json
• package/dist/issue-descriptions.json
• package/dist/bundle/checkpoints.json

Stappen:

1. Maak een nieuw array-object voor de standaard in standards.json. De eenvoudigste aanpak is om het hele object voor wcag21aa te kopiëren en aan de onderkant van het bestand toe te voegen.
2. Verander de id van het nieuw gekopieerde object naar iets unieks dat de standaard die het vertegenwoordigt aangeeft.
3. Werk de rubric-array bij voor het nieuwe object om alle onderliggende teststandaarden te vertegenwoordigen die deel uitmaken van deze nieuwe standaard.
4. In descriptions.json, voeg voor alle regels die bij uw nieuwe standaard horen, de id van de nieuwe standaard (uit standards.json) toe aan de standards-array.
5. In testingMethodologies.json, voeg de id van de nieuwe standaard toe onder de standards-array voor elk type digitaal bestand waarop deze standaard van toepassing is.
6. In standards.en.json, voeg een nieuw object toe met de id en naam van de nieuwe standaard. Het name-veld is wat gebruikers zien in de gebruikersinterface van axe Auditor.
7. In dist/checkpoints.json, werk de standards-array bij onder elke probleemomschrijving voor de toepasselijke controlepunten.
8. In issue-descriptions.json, werk de standards-array bij voor alle toepasselijke regelobjecten.
9. In dist/bundle/checkpoints.json, werk de standards-array van elk toepasselijk controlepunt bij met de juiste standaard.

Werk de korte en lange probleemomschrijvingen voor specifieke regels bij

Gebruik deze instructies om de tekstselectie voor de probleemomschrijving (korte tekst) en de lange beschrijving van het probleemtype voor elke regel bij te werken. Een enkele regel kan meerdere WCAG-succescriteria beïnvloeden — het wijzigen van deze tekst beïnvloedt alles succescriteria waarmee het verbonden is.

Bijgewerkte bestanden: package/dist/bundle/locales/descriptions.en.json

Stappen:

1. In descriptions.en.json, zoek naar de specifieke regel (bijv. alt-text-dynamic-image-inconsistent).
2. Werk de tekst bij voor shortText (Korte Probleembeschrijving) en issueDescText (Lange Probleembeschrijving) indien nodig.
3. Sla het bestand op in de huidige locatie.

Werk de aanbeveling voor de Remediëring bij

Als u de bibliotheek voor remediëring en de bijbehorende beschrijvingen wilt wijzigen om beter bij uw beleid te passen, gebruik dan de volgende instructies.

Bijgewerkte bestanden: package/dist/bundle/locales/recommendations.en.json

Stappen:

1. In recommendations.en.json, zoek naar de specifieke regel (bijv. alt-text-dynamic-image-inconsistent) en controlecombinatie waarvoor u de remediëringsbibliotheek wilt wijzigen.
2. Werk de tekst bij voor recommendationType (Aanbevelingstechniek), rule, howtofix en background (secties van de aanbeveling om te verhelpen) indien nodig.
3. Sla het bestand op in de huidige locatie.

Verwijder digitale bestandstypen

Gebruik dit wanneer een bepaald bestandstype niet van toepassing is op uw organisatie (bijvoorbeeld als PDF- of Android-tests buiten de scope vallen).

Bestanden die moeten worden bijgewerkt:

• dist/bundle/testingMethodologies.json — hoofdgegevens testmethodologieën
• dist/bundle/locales/testingMethodologies.en.json — Engelse vertalingen

Stap 1: Verwijder uit het testmethodologieënbestand

Bestand: dist/bundle/testingMethodologies.json

Vind en verwijder het gehele object voor de methodologie die u wilt verwijderen.

// BEFORE — remove this entire object (example: "native-mobile-android"):
{
  "id": "native-mobile-android",
  "techniques": ["general"],
  "standards": [
    "wcag2a", "wcag21a", "wcag22a",
    "wcag2aa", "wcag21aa", "wcag22aa",
    "acaa", "en301549-wad",
    "508-2017-wcag2", "508-2017-wcag21"
  ]
}
// AFTER — object completely removed

Stap 2: Verwijder uit het Engelse lokalebestand

Bestand: dist/bundle/locales/testingMethodologies.en.json

Verwijder hetzelfde methodologie-object uit dit bestand.

Voeg een nieuw digitaal bestandstype toe

Gebruik dit om een nieuw type digitaal bestand toe te voegen — bijvoorbeeld een web-app of macos-methodologie. Het onderstaande voorbeeld gebruikt web-app; vervang deze door uw eigen asset-type-id indien nodig.

Bestanden die moeten worden bijgewerkt:

• dist/bundle/testingMethodologies.json — hoofdgegevens testmethodologieën
• dist/bundle/locales/testingMethodologies.en.json — Engelse vertalingen
• dist/bundle/locales/checkpoints.en.json — Engelse checkpointinhoud met testmethodologie-secties
• dist/bundle/checkpoints.json — hoofdcontrolepuntengegevens
• dist/bundle/descriptions.json — probleemomschrijvingen met referenties naar testmethodologieën
• dist/bundle/schemata.json — schema-definities met referenties naar testmethodologieën

Stap 1: Voeg toe aan het testmethodologieënbestand

Bestand: dist/bundle/testingMethodologies.json

Voeg het nieuwe methodologie-object toe aan de array.

{
  "id": "web-app",
  "techniques": ["general", "html", "aria", "css"],
  "standards": [
    "wcag2a", "wcag21a", "wcag22a",
    "wcag2aa", "wcag21aa", "wcag22aa",
    "acaa", "en301549-wad",
    "508-2017-wcag2", "508-2017-wcag21"
  ]
}

Stap 2: Voeg toe aan het Engelse lokalebestand

Bestand: dist/bundle/locales/testingMethodologies.en.json

Voeg hetzelfde methodologie-object toe aan dit bestand.

Stap 3: Voeg referenties toe aan het checkpointbestand

Bestand: dist/bundle/checkpoints.json

Voor elk checkpoint dat de nieuwe methodologie moet ondersteunen, voeg het toe aan de testingMethodologies array van dat checkpoint.

{
  "id": "1.4.3.a",
  "testingMethodologies": [
    "desktop", "mobile", "kiosk",
    "native-mobile-ios", "native-mobile-android",
    "pdf",
    "web-app",          // ← Add this line
    "ms-excel", "ms-powerpoint", "ms-word", "windows-desktop"
  ]
}

Stap 4: Voeg testmethodologie-inhoud toe aan het checkpoint locale bestand

Bestand: dist/bundle/locales/checkpoints.en.json

Voor elk checkpoint dat de nieuwe methodologie moet ondersteunen, voeg de inhoud van de testmethodologie toe.

{
  "1.4.3.a": {
    "name": "Color Contrast (Minimum)",
    "testing-methodology": {
      "desktop": "<ol>...</ol>",
      "mobile": "<ol>...</ol>",
      "native-mobile-android": "<ol>...</ol>",
      "web-app": "<ol>\n<li>Open the web application in a modern browser</li>\n<li>Use browser developer tools to inspect text elements</li>\n<li>Check color contrast ratios using accessibility tools</li>\n<li>Verify contrast meets WCAG requirements</li>\n</ol>",  // ← Add this new entry
      "pdf": "<ol>...</ol>"
    }
  }
}

Stap 5: Voeg referenties toe aan het beschrijvingenbestand

Bestand: dist/bundle/descriptions.json

Voor probleemomschrijvingen die de nieuwe methodologie moeten ondersteunen, voeg het toe aan hun testingMethodologies array.

{
  "id": "some-issue-id",
  "data": [
    {
      "type": "issue",
      "testingMethodologies": [
        "desktop", "mobile",
        "native-mobile-android", "pdf",
        "web-app"        // ← Add this line
      ]
    }
  ]
}

Stap 6: Voeg referenties toe aan het schemabestand

Bestand: dist/bundle/schemata.json

Voeg de nieuwe testmethodologie toe aan de schema-definities.

{
  "testingMethodologies": {
    "desktop": null,
    "kiosk": null,
    "mobile": null,
    "native-mobile-ios": null,
    "native-mobile-android": null,
    "pdf": null,
    "web-app": null,   // ← Add this line
    "ms-excel": null,
    "ms-powerpoint": null,
    "ms-word": null,
    "windows-desktop": null
  }
}

Een nieuw checkpoint toevoegen

Een niet-WCAG checkpoint toevoegen

Belangrijk: Checkpoints die niet aan WCAG voldoen, ondersteunen niet voorgeconfigureerde beschrijvingen of aanbevelingen via descriptions.json en recommendations.json niet. Wanneer je problemen logt met deze checkpoints, voer je handmatig beschrijvingen en aanbevelingen in met behulp van de Maak je eigen beschrijving functie in de tool.

Bestanden om bij te werken — alleen 2:

• package/dist/bundle/checkpoints.json — definieer het checkpoint
• package/dist/bundle/locales/checkpoints.en.json — bied gelokaliseerde testmethodologie aan

Stap 1: Voeg het checkpoint toe aan checkpoints.json

{
  "id": "custom.1.1",
  "requiredSenses": {
    "sight": true,
    "hearing": false
  },
  "successCriteria": "",
  "automatedRules": [],
  "testingMethodologies": ["desktop", "mobile"],
  "grouping": "custom.1",
  "categories": [],
  "standards": ["custom"]
}

Belangrijke velden:

• id — unieke identificatie met je eigen formaat (bijv. custom.1.1, brand.2.3, TT.01.A, s.1.1).
• successCriteria — lege string "" voor niet-WCAG checkpoints (of een eigen formaat zoals "tt-01.A").
• standards — je eigen standaardidentifier, bijv. ["custom"], ["TT508"], ["smoke"], ["brand"] (niet ["wcag2a"]).
• testingMethodologies — platforms waar dit checkpoint van toepassing is: desktop, mobile, kiosk, native-mobile-ios, native-mobile-android, pdf, windows-desktop, ms-excel, ms-powerpoint, ms-word.
• requiredSenses — welke zintuigen nodig zijn om dit checkpoint te testen (sight, hearing: true/false).
• automatedRules — optionele array van geautomatiseerde regel-ID's (meestal lege [] voor eigen checkpoints).
• grouping — logische groepering voor organisatie (bijv. "custom.1", "1", "s.1").
• categories — relevante toegankelijkheidscategorieën (kan lege [] zijn voor niet-WCAG).
• terms — optionele array van verklarende woordenlijstverwijzingen met id en ordinal eigenschappen.

Stap 2: Voeg de gelokaliseerde inhoud toe aan checkpoints.en.json

Gebruik het met koppelteken id-formaat: zet punten om in streepjes (bijv. custom-1-1, niet custom.1.1).

"custom-1-1": {
  "examples": "<ul>\n  <li>Example 1: Describe a scenario where this applies</li>\n  <li>Example 2: Describe another scenario</li>\n</ul>",
  "related-techniques": {
    "general": "<ul>\n  <li>Technique reference 1</li>\n  <li>Technique reference 2</li>\n</ul>",
    "html": "<ul>\n  <li>HTML-specific technique</li>\n</ul>"
  },
  "testing-methodology": {
    "desktop": "<ol>\n  <li>Step 1 for desktop testing</li>\n  <li>Step 2 for desktop testing</li>\n</ol>",
    "mobile": "<ol>\n  <li>Step 1 for mobile testing</li>\n  <li>Step 2 for mobile testing</li>\n</ol>"
  },
  "name": "Your Custom Checkpoint Name",
  "overview": {
    "general": "General description of what this checkpoint tests and why it matters for accessibility.",
    "html": "HTML-specific description if applicable; otherwise can match general."
  }
}

Gebruik \n voor regeleinden en correcte HTML-tags voor lijsten.

Een WCAG checkpoint toevoegen

Bestanden om bij te werken — 6 bestanden voor een volledige WCAG-checkpointimplementatie:

1. package/dist/bundle/checkpoints.json — definieer het checkpoint met WCAG-specifieke velden.
2. package/dist/bundle/locales/checkpoints.en.json — gelokaliseerde testmethodologie, voorbeelden, gerelateerde technieken (gebruik het id-formaat met koppelteken: 1-4-3-a, niet 1.4.3.a).
3. package/dist/bundle/descriptions.json — probleemomschrijvingen met impactniveaus en checkpointreferenties.
4. package/dist/bundle/locales/descriptions.en.json — gelokaliseerde probleemomschrijvingen.
5. package/dist/bundle/recommendations.json — herstel aanbevelingen gekoppeld aan probleemomschrijvingen.
6. package/dist/bundle/locales/recommendations.en.json — gelokaliseerde aanbevelingsinhoud (titel, beschrijving, stappen, bronnen).

Optioneel — handmatige invoer: Als je liever geen vooraf gedefinieerde beschrijvingen en aanbevelingen toevoegt aan de JSON-bestanden, kun je dit aanpakken bij het loggen van problemen in de tool: selecteer je WCAG-checkpoint, kies Maak je eigen beschrijving in plaats van een vooraf gedefinieerde, en voer dan handmatig de beschrijving en (indien nodig) aanbeveling in die is afgestemd op het gevonden probleem.

Stap 1: Definieer het checkpoint

Bestand: package/dist/bundle/checkpoints.json

{
  "id": "1.4.3.a",
  "requiredSenses": {
    "sight": true,
    "hearing": false
  },
  "successCriteria": "1.4.3",
  "automatedRules": ["color-contrast"],
  "testingMethodologies": [
    "desktop", "mobile", "kiosk",
    "native-mobile-ios", "native-mobile-android",
    "pdf", "ms-excel", "ms-powerpoint", "ms-word", "windows-desktop"
  ],
  "grouping": "1.4",
  "categories": ["cat.distinguishable"],
  "standards": ["wcag2aa"]
}

Belangrijke velden:

• id — WCAG nummereringspatroon (bijv. "1.4.3.a", "2.1.1.b").
• successCriteria — WCAG succescriteria nummer (bijv. "1.4.3").
• standards — "wcag2a" (Niveau A), "wcag2aa" (Niveau AA), of "wcag2aaa" (Niveau AAA).
• automatedRules — reeks van geautomatiseerde regel-ids.
• grouping — WCAG richtlijnnummer (bijv. "1.4", "2.1").

Stap 2: Voeg de testmethodologie toe

Bestand: package/dist/bundle/locales/checkpoints.en.json — gebruik het gekoppelde formaat (1-4-3-a).

"1-4-3-a": {
  "name": "Color Contrast (Minimum)",
  "overview": {
    "general": "Text and images of text have a contrast ratio of at least 4.5:1, except for large text which has a contrast ratio of at least 3:1.",
    "html": "Text and images of text have a contrast ratio of at least 4.5:1, except for large text which has a contrast ratio of at least 3:1."
  },
  "examples": "<ul>\n  <li>Gray text on white background with insufficient contrast</li>\n  <li>Blue text on blue background that doesn't meet requirements</li>\n</ul>",
  "testing-methodology": {
    "desktop": "<ol>\n  <li>Identify all text content on the page</li>\n  <li>Use a color contrast analyzer tool</li>\n  <li>Ensure normal text has at least 4.5:1 contrast ratio</li>\n  <li>Ensure large text has at least 3:1 contrast ratio</li>\n</ol>",
    "mobile": "<ol>\n  <li>Test on a mobile device under various lighting conditions</li>\n  <li>Use mobile accessibility testing tools</li>\n  <li>Verify contrast ratios meet WCAG requirements</li>\n</ol>",
    "assistive-technology": "<p><strong>Screen reader testing is optional for this checkpoint.</strong></p>\n<p><strong>Using NVDA:</strong></p>\n<ol>\n  <li>Navigate through text content</li>\n  <li>Verify text readability</li>\n</ol>"
  },
  "related-techniques": {
    "general": "<ul>\n  <li><a href=\"https://www.w3.org/WAI/WCAG22/Techniques/general/G18\">G18: Ensuring contrast ratio of at least 4.5:1</a></li>\n</ul>",
    "html": "<ul>\n  <li><a href=\"https://www.w3.org/WAI/WCAG22/Techniques/css/C21\">C21: Specifying line spacing in CSS</a></li>\n</ul>"
  }
}

Stap 3: Voeg probleemomschrijvingen toe

Bestand: package/dist/bundle/descriptions.json

{
  "id": "insufficient-color-contrast",
  "data": [
    {
      "type": "issue",
      "impact": 4,
      "checkpoint": "1.4.3.a",
      "standards": ["wcag2aa"],
      "references": [
        {
          "standards": ["wcag2aa"],
          "checkpoint": "1.4.3.a"
        }
      ],
      "testingMethodologies": ["desktop", "mobile"]
    }
  ]
}

Stap 4: Voeg gelokaliseerde probleemomschrijvingen toe

Bestand: package/dist/bundle/locales/descriptions.en.json

Voeg een object toe voor de nieuwe beschrijving:

"insufficient-color-contrast": {
  "shortText": "Insufficient color contrast",
  "issueDescText": "Text does not have sufficient contrast against its background to meet WCAG 2.1 AA requirements."
}

Stap 5: Voeg aanbevelingen toe

Bestand: package/dist/bundle/recommendations.json

Gebruik het gekoppelde formaat (1-4-3-a) en voeg het toe aan de aanbevelings-id.

{
  "id": "insufficient-color-contrast-fix-1-4-3-a",
  "data": [
    {
      "type": "recommendation",
      "description": "insufficient-color-contrast"
    }
  ]
}

Stap 6: Voeg aanbevelingsinhoud toe

Bestand: package/dist/bundle/locales/recommendations.en.json

"insufficient-color-contrast-fix-1-4-3-a": {
  "title": "Improve Color Contrast",
  "description": "Increase the contrast ratio between text and background colors to meet WCAG 2.1 AA requirements.",
  "steps": [
    "Use a color contrast analyzer to identify insufficient contrast",
    "Adjust text color, background color, or both to achieve a minimum 4.5:1 ratio",
    "For large text (18pt+ or 14pt+ bold), ensure a minimum 3:1 ratio",
    "Test the changes across different devices and lighting conditions"
  ],
  "resources": [
    "WebAIM Color Contrast Checker",
    "W3C Color Contrast Analyzer",
    "Chrome DevTools Accessibility Panel"
  ]
}

Verwijder een specifiek checkpoint

Gebruik deze instructies als er een specifiek checkpoint is dat je team niet moet testen en rapporteren.

Bestanden bijgewerkt:

• package/dist/bundle/checkpoints.json
• package/dist/bundle/descriptions.json
• package/dist/bundle/recommendations.json
• package/dist/bundle/locales/checkpoints.en.json
• package/dist/bundle/locales/recommendations.en.json

Stappen:

1. In checkpoints.json, zoek naar het specifieke checkpoint (bijv. 1.2.1.b). Verwijder het hele object dat bij dit checkpoint hoort, terwijl je een geldig JSON behoudt. Sla het bestand op.
2. In descriptions.json, zoek naar het specifieke checkpoint (bijv. 1.2.1.b). Verwijder alleen het object dat het checkpoint onder de regel gebruikt, terwijl je een geldig JSON behoudt. Een enkele regel kan van toepassing zijn op meerdere checkpoints — verwijder alleen het object voor het checkpoint dat je verwijdert; verwijder niet de volledige regel. Sla het bestand op.
3. In recommendations.json, zoek naar het specifieke checkpoint (bijv. 1.2.1.b). Verwijder elk object dat bij dit checkpoint hoort (er kunnen er meer dan één zijn), terwijl je een geldig JSON behoudt. Sla het bestand op.
4. In checkpoints.en.json, zoek naar het specifieke checkpoint met behulp van het gekoppelde formaat (bijv. 1-2-1-b). Verwijder het hele object terwijl je een geldig JSON behoudt. Sla het bestand op.
5. In recommendations.en.json, zoek naar het specifieke checkpoint met behulp van het gekoppelde formaat (bijv. 1-2-1-b). Verwijder elk object dat bij dit checkpoint hoort (er kunnen er meer dan één zijn), terwijl je een geldig JSON behoudt. Sla het bestand op.

Wijzigingen terugsturen naar Deque

Wanneer bewerkingen zijn voltooid en gevalideerd:

1. Bevestig dat elk bewerkt bestand nog steeds slaagt voor JSON-validatie (zie Voordat je begint).
2. Bevestig dat de wijzigingen overeenkomen met de afgesproken scope.
3. Stuur de hele package map terug naar Deque in zijn originele structuur (stuur niet alleen individuele bestanden).

Deque wijst de versie toe, verpakt de bundel, koppelt het aan de juiste axe-core versie en zet het in een testomgeving voor verificatie. Nadat je team de wijzigingen op de testomgeving heeft geverifieerd en goedgekeurd, promoot Deque de methodologie naar je productie-omgeving.

Ondersteuning

Voor vragen over dit proces, de afgesproken wijzigingsscope, of om extra taalondersteuning aan te vragen, neem contact op met je Deque-contactpersoon.