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:
co-authored by
Claude Opus 5
parent
956e57f234
commit
fb8abcaa74
+7
-8
@@ -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:
|
||||||
|
|||||||
Reference in New Issue
Block a user