Review our use of the `default` OpenAPI spec feature

Aperta
#207 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
openapi
Ambito
api, documentation

Direzione di ricerca

Iniziate individuando la specifica TAMS OpenAPI e cercando ogni utilizzo della funzionalità default. Esaminate come questi valori predefiniti possano influire sulla convalida delle richieste e sulle implementazioni, quindi documentate le raccomandazioni in una Application Note e applicate le modifiche concordate all'intera specifica.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Context
The TAMS spec has avoided the use of OpenAPI spec's default feature as it can lead to unexpected behaviour in some cases. For example, libraries that validate requests against the spec sometimes automatically set the defaults. We should review how widely we use the default feature and provide clear guidance on its use.

Actions

  • Review our use of the OpenAPI spec default feature in TAMS, including where it may result in unexpected behaviour
  • Review the impact the change will have on implementations
  • Write up recommendations for its use in TAMS
  • Roll out these recommendations across its spec

Outcome

  • Application Note on use of the OpenAPI spec default feature
  • Spec changes as appropriate
Lingua principale
Makefile
Stelle
117
Fork
13
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di bbc/tams

Tutte le issue di bbc/tams

Issue simili

Altre issue su Backend & API Design

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.