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 type: object
properties: properties:
minutes: minutes:
type: integer type: [integer, "null"]
nullable: true
maximum: 0 maximum: 0
minimum: -10080 minimum: -10080
description: | description: |
@@ -4844,18 +4843,18 @@ components:
The sidebar headings this person has folded away. Always an array, 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 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. empty one will one day check for only one of them.
example: ["labels"]
default_reminder_min: default_reminder_min:
type: integer type: [integer, "null"]
nullable: true
description: | description: |
The account's standing alarm on tasks that have a clock, as minutes 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, relative to the due moment and negative for before it. Null is off,
which is where every account starts. which is where every account starts.
Nullable rather than a number with a sentinel, because zero is a real A type union rather than a number with a sentinel, because zero is a
setting here — an alarm exactly at the due moment — so "off" and "at real setting here — an alarm exactly at the due moment — so "off" and
the time" have to stay different answers. "at the time" have to stay different answers.
example: ["labels"] example: -10
created_at: { type: string, format: date-time } created_at: { type: string, format: date-time }
RecoveryCodes: RecoveryCodes: