Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

document design principle around nullability

Abierto
  • ¿Algo no está bien?
#20 0 comentarios 0 reacciones 1 asignado Ver en GitHub

@darrelmiller ya está trabajando en esto.

Desde el 25/8/2023.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

We keep getting questions about nullability when we project the client.
We should document the facts that:

  • we project a nullable return type for the root of the response, even if the description doesn't say it's nullable. This is so the client can survive change in service behaviour without being refreshed. (e.g. the service starts returning 204)
  • we project properties on models as nullable. This is to account for services that allow selection/projection via query parameters where the returned payload might omit described properties.
  • we project request bodies as nullable or not depending on the required property in the description
Lenguaje dominante
Sin datos de lenguaje
Estrellas
22
Forks
50
Merge medio
5 d 3 h
PR fusionados (30 d)
3

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de MicrosoftDocs/openapi-docs

Todos los issues de MicrosoftDocs/openapi-docs

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.