Updated information about the ADR Checker and fixed syntax higlighting for bash. (#851)

* Updated information about the ADR Checker and
fixed syntax higlighting for `bash`.

* Remove IDE reference from ADR Checker tutorial

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: dvh

.changeset/clean-colts-buy.md

@@ -0,0 +1,5 @@
+---
+"@developer-overheid-nl/website": minor
+---
+
+Updated information about the ADR Checker. Fixed syntax highlighting for `bash`.

docs/api-ontwikkeling/standaarden/api-design-rules/cheat-sheet.md

@@ -133,5 +133,5 @@ Voorbeeld van een geldig `info.servers` object:
 
 ## Tools
 
-- [API Design Rules Linter](../../tools/api-design-rules-linter)
+- [API Design Rules Checker](../../tools/api-design-rules-linter)
 - [OpenAPI Spec generator](../../tools/openapi-specification-generator)

docs/api-ontwikkeling/standaarden/api-design-rules/index.mdx

@@ -14,7 +14,7 @@ van de overheid.
 
 De REST API Design Rules (ADR) schrijven voor waar een REST API van de overheid
 aan moet voldoen. Een aantal van deze regels is automatisch te testen met de
-[ADR Linter](../../tools/api-design-rules-linter).
+[ADR Checker](../../tools/api-design-rules-linter).
 
 Een van de belangrijkste redenen om de API Design Rules te volgen is
 interoperabiliteit. API’s worden gebruikt om verschillende informatiesystemen

docs/api-ontwikkeling/tools/api-design-rules-linter.md

@@ -3,20 +3,20 @@ content_type: tool
 tags: [adr, api]
 ---
 
-# ADR Linter
+# ADR Checker
 
-De ADR Linter controleert of een OpenAPI Specificatie compliant is met de API
-Design Rules. De linter is gebaseerd op het Open Source project
-[Spectral](https://github.com/stoplightio/spectral).
+De ADR Checker controleert of een OpenAPI Specificatie compliant is met de API
+Design Rules. De checker is gebaseerd op de
+[DON Checker](https://github.com/developer-overheid-nl/don-checker).
 
 ## Browser
 
-Een OpenAPI Specificatie kan online getest worden via onze online OAS Checker:
-[https://developer-overheid-nl.github.io/oas-checker](https://developer-overheid-nl.github.io/oas-checker)
+Een OpenAPI Specificatie kan online getest worden via onze online ADR Checker:
+[https://developer-overheid-nl.github.io/don-checker/#/adr](https://developer-overheid-nl.github.io/don-checker/#/adr)
 
 ### Resultaten interpreteren
 
-De OAS Checker toont drie soorten meldingen:
+De ADR Checker toont drie soorten meldingen:
 
 | Type    | Betekenis                                                                  |
 | ------- | -------------------------------------------------------------------------- |
@@ -26,67 +26,70 @@ De OAS Checker toont drie soorten meldingen:
 
 ## CLI
 
-Nadat je Spectral geïnstalleerd hebt, kun je een OAS via de commandline op de
-volgende manier valideren:
+Je kunt een OAS via de commandline op de volgende manier valideren:
 
-```bash
-$ npm install -g @stoplight/spectral-cli
-$ spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE
-```
-
-## IDE
-
-Sommige IDEs ondersteunen Spectral via extensies of plugins.
-
-### Visual Studio Code
-
-Hieronder staat beschreven hoe je de ADR Linter kunt gebruiken met
-[de officiele Spectral extensie voor Visual Studio Code](https://github.com/stoplightio/vscode-spectral):
+```sh
+# From a local file (ADR, default version)
+npx @developer-overheid-nl/don-checker@latest validate --standard adr --input ./openapi.json
 
-```bash
-# Install the extension from the vscode marketplace
-$ code --install-extension stoplight.spectral
-
-# Download the ruleset to your project home
-$ curl -L https://static.developer.overheid.nl/adr/ruleset.yaml > .spectral.yml
-
-# Run the IDE
-$ code
-```
-
-### IntelliJ IDEA
+# Pin a specific version
+npx @developer-overheid-nl/don-checker@latest validate --standard adr --version 2.1.0 --input ./openapi.json
 
-Voor IntelliJ-based IDEs (IntelliJ IDEA, WebStorm, etc.) is er de
-[Spectral plugin](https://plugins.jetbrains.com/plugin/18520-spectral). Na
-installatie kun je een `.spectral.yaml` bestand in je project root plaatsen met
-de volgende inhoud:
+# From an external file (ADR, default version)
+npx @developer-overheid-nl/don-checker@latest validate --standard adr \
+  --input https://api.developer.overheid.nl/api-register/v1/openapi.json
 
-```yaml
-extends:
-  - https://static.developer.overheid.nl/adr/ruleset.yaml
+# From stdin
+cat openapi.json | npx @developer-overheid-nl/don-checker@latest validate --standard adr
 ```
 
 ## Docker
 
 ```bash
-$ docker run --rm --entrypoint=sh \
-    -v $(pwd)/api:/locale stoplight/spectral \
-    -c "spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE"
+docker run --rm node:24-alpine \
+  npx @developer-overheid-nl/don-checker@latest validate --standard adr \
+    --input https://api.developer.overheid.nl/api-register/v1/openapi.json
 ```
 
-## GitLab
-
-```yaml
-spectral-lint:
-  image: node:20
-  stage: spectral_lint
-  script:
-    - npm install -g @stoplight/spectral-cli
-    - curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >
-      .spectral.yml
-    - spectral lint -r .spectral.yml $OAS_URL_OR_FILE
-  rules:
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-      when: always
-    - when: manual
-```
+## Git workflows
+
+import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem";
+
+<Tabs groupId="git-workflow">
+  <TabItem value="gitlab" label="GitLab CI">
+    ```yaml title=".gitlab-ci.yml"
+    adr-check:
+      image: node:24
+      stage: adr_check
+      script:
+        - npx @developer-overheid-nl/don-checker@latest validate --standard adr --input $OAS_URL_OR_FILE
+      rules:
+        - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+          when: always
+        - when: manual
+    ```
+  </TabItem>
+  <TabItem value="github" label="GitHub Actions" default>
+  ```yaml title=".github/workflows/adr-check.yml"
+  name: ADR check
+  on:
+    pull_request:
+    workflow_dispatch:
+  jobs:
+    adr-check:
+      runs-on: ubuntu-latest
+      steps:
+        - uses: actions/checkout@v4
+        - uses: actions/setup-node@v4
+          with:
+            node-version: 24
+        - name: Valideer OAS tegen de API Design Rules
+          run: |
+            npx @developer-overheid-nl/don-checker@latest validate \
+              --standard adr --input ${{ env.OAS_URL_OR_FILE }}
+          env:
+            OAS_URL_OR_FILE: ./openapi.json
+  ```
+  </TabItem>
+  
+</Tabs>

docs/api-ontwikkeling/tools/api-design-rules-validator.md

@@ -1,14 +1,14 @@
 ---
-content_type: tool
 tags: [adr, api, validator]
+unlisted: true
 ---
 
 # ADR Validator (verouderd)
 
 :::danger[Deze tool is verouderd]
 
 Deze tool wordt niet meer onderhouden en is niet meer up-to-date. Gebruik in
-plaats hiervan de [ADR Linter](api-design-rules-linter.md).
+plaats hiervan de [ADR Checker](api-design-rules-linter.md).
 
 :::
 

docs/api-ontwikkeling/tutorials/bouw-een-api/4-valideer-oas.md

@@ -536,9 +536,9 @@ erachter. De waarde van de server `url` wordt dus:
 :::tip Lokale validatie
 
 Voor grotere projecten is het handig om de validatie te integreren in de
-development workflow. De ADR Linter kan ook via CLI, in de IDE, of in CI/CD
-pipelines draaien. Zie de
-[ADR Linter documentatie](/kennisbank/api-ontwikkeling/tools/api-design-rules-linter)
+development workflow. De ADR Checker kan ook via CLI of in CI/CD pipelines
+draaien. Zie de
+[ADR Checker documentatie](/kennisbank/api-ontwikkeling/tools/api-design-rules-linter)
 voor meer informatie.
 
 :::

docs/api-ontwikkeling/tutorials/bouw-een-api/5-genereer-api-code.md

@@ -460,5 +460,5 @@ overheidsstandaarden en om die specificatie om te zetten naar werkende code.
   beschikbare generators
 - [Codegen templates](https://github.com/developer-overheid-nl/codegen-templates) -
   DON-templates voor OpenAPI Generator
-- [ADR Linter](/kennisbank/api-ontwikkeling/tools/api-design-rules-linter) -
-  Valideer de OAS via CLI, IDE of CI/CD
+- [ADR Checker](/kennisbank/api-ontwikkeling/tools/api-design-rules-linter) -
+  Valideer de OAS via CLI of CI/CD

docusaurus.config.ts

@@ -480,7 +480,7 @@ const config: Config & {
     },
     prism: {
       theme: emptyTheme, // CSS classes are used; see presets.theme.customCss
-      additionalLanguages: ["turtle", "java", "go"],
+      additionalLanguages: ["bash", "turtle", "java", "go"],
     },
     colorMode: {
       defaultMode: "light",

src/components/TilesGrid/homepage-tiles.tsx

@@ -118,11 +118,7 @@ const tiles: GridTile[] = [
     description: [
       {
         link: "/kennisbank/api-ontwikkeling/tools/api-design-rules-linter",
-        label: "ADR Linter",
-      },
-      {
-        link: "/kennisbank/api-ontwikkeling/tools/api-design-rules-validator",
-        label: "ADR Validator",
+        label: "ADR Checker",
       },
       {
         link: "/kennisbank/api-ontwikkeling/tools/openapi-specification-generator",