fix(docs): nullable er ikke 3.1, og eksemplet hørte til nabofeltet

To fejl i samme blok, begge mine.

`nullable: true` er OpenAPI 3.0. Specen er 3.1, hvor det blev fjernet til
fordel for en type-union, og den havde allerede fortilfældet stående:
`type: [integer, "null"]`. Redocly afviste de to steder som struktur-fejl.

Og min lokale kontrol stillede et svagere spørgsmål end CI's: jeg læste
filen med `yaml.safe_load` og fik "gyldig" tilbage. Den svarede på, om det
er YAML — ikke om det er en gyldig OpenAPI. CI's egen validator kører nu
lokalt, før den kører der.

Den anden fejl fandt kun en ADVARSEL: `example: ["labels"]` tilhørte
sidebar_collapsed, og min indsættelse landede før den, så en strengliste
hang på et heltalsfelt. Ankeret dækkede ikke hele blokken, jeg skød ind
efter. CI fejler kun på fejl, så den var sluppet igennem — på to felter ad
gangen, for sidebar_collapsed stod samtidig uden sit eget eksempel.

Advarsler: 253, som før ændringen. Specen er gyldig.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
kristianwind
2026-10-08 19:34:05 +02:00
co-authored by Claude Opus 5
parent 956e57f234
commit fb8abcaa74
+7 -8
View File
@@ -304,8 +304,7 @@ paths:
type: object
properties:
minutes:
type: integer
nullable: true
type: [integer, "null"]
maximum: 0
minimum: -10080
description: |
@@ -4844,18 +4843,18 @@ components:
The sidebar headings this person has folded away. Always an array,
never null: a client that has to check for both an absent array and an
empty one will one day check for only one of them.
example: ["labels"]
default_reminder_min:
type: integer
nullable: true
type: [integer, "null"]
description: |
The account's standing alarm on tasks that have a clock, as minutes
relative to the due moment and negative for before it. Null is off,
which is where every account starts.
Nullable rather than a number with a sentinel, because zero is a real
setting here — an alarm exactly at the due moment — so "off" and "at
the time" have to stay different answers.
example: ["labels"]
A type union rather than a number with a sentinel, because zero is a
real setting here — an alarm exactly at the due moment — so "off" and
"at the time" have to stay different answers.
example: -10
created_at: { type: string, format: date-time }
RecoveryCodes: