microsoft / microsoft/OpenAPI.NET.OData
add dynamicRef/generic support for collections when openapi 3.1 is supported
Abierto
Nadie ha tomado este issue todavía.
blocked
type:enhancement
- Lenguaje dominante
- C#
- Estrellas
- 240
- Forks
- 70
- Merge medio
- 7 h 59 min
- PR fusionados (30 d)
- 13
Descripción
today we implement collections as:
- BaseCollectionResponse (Odata next link field, etc...)
- BaseCounCollectionResponse (inherits from the previous, add the count field)
- A lot of Users/Groups/Sites/...Collection response (inherits from one of the previous, adds the value property)
With the advent of OpenAPI 3.1 support we could get rid of all the UsersCollectionResponse schemas (about 4k in v1) and make the base types generic.
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Comienza revisando la generación del esquema de respuesta de collection y la compatibilidad del repositorio con OpenAPI 3.1. Define los tipos base genéricos de collection y el comportamiento de dynamicRef; después, verifica que el documento generado ya no necesite los numerosos esquemas de collection específicos de los recursos.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- csharp
- Área
- api
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Estancado
- Claridad
- Necesita aclaración
- Aptitud para principiantes
- 30/100