Skip to content

Commit 4640e3c

Browse files
committed
slides dimitri
1 parent f730084 commit 4640e3c

5 files changed

Lines changed: 50 additions & 8 deletions

File tree

171 KB
Loading

shows/20260422-don-update/index.md

Lines changed: 50 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -116,20 +116,62 @@ p {
116116
## Nieuwe checker
117117
<!-- Dimitri -->
118118

119-
- Architectuur
120-
- CLI
121-
- Severities
122-
- YAML support
119+
- CLI support, dus geen Spectral meer nodig:
120+
121+
```bash
122+
npx @developer-overheid-nl/don-checker@latest \
123+
validate \
124+
--ruleset adr-21 \
125+
--input https://api.developer.overheid.nl/api-register/v1/openapi.json
126+
```
127+
128+
- YAML ↔ JSON tbv publiccode.yml, leesbaarheid OpenAPI Specs
129+
- Verschillende versies binnen een standaard
130+
- Results gegroepeerd per severity-level: error, warning, info, hint
131+
132+
## Severities
133+
<!-- _class: image -->
134+
<!-- Dimitri -->
135+
136+
![package](./checker_severities.png)
137+
138+
## NPM Packages
139+
<!-- Dimitri -->
123140

124-
## Schema-register
141+
![package](./npm_package.png)
142+
143+
## JSON Schema register
125144
<!-- Dimitri -->
126145

127-
- OpenAPI 3.1
146+
- OpenAPI 3.1 komt eraan!
147+
![ptolu](./ptolu.png)
148+
128149
- Herbruikbare JSON Schema's
129150
- Herbruikbare OAS components
151+
152+
## Huidige work-in-progress
153+
154+
![package](./schemas_architectuur.png)
155+
156+
## Voorbeeld
157+
158+
```yaml
159+
headers:
160+
API-Version:
161+
$ref: https://components.developer.overheid.nl/oas/adr/api-version.json
162+
description: Bad request
163+
content:
164+
application/problem+json:
165+
schema:
166+
$ref: https://schemas.developer.overheid.nl/adr/problem-json.json
167+
```
168+
169+
## Vervolg
170+
130171
- Schema Design Rules
131-
- JSON-LD
132-
- Nieuwe werkgroep: <d.vanhees@geonovum.nl>
172+
- JSON-LD koppeling voor semantiek
173+
- Nieuwe werkgroep Kennisplatform API's: JSON Schema
174+
- Meedoen: <d.vanhees@geonovum.nl>
133175
134176
## Publiccode.yml
135177
<!-- Tom -->
448 KB
Loading
22.5 KB
Loading
617 KB
Loading

0 commit comments

Comments
 (0)