microsoft / microsoft/OpenAPI.NET.OData
add dynamicRef/generic support for collections when openapi 3.1 is supported
Offen
Dieses Issue hat noch niemand übernommen.
blocked
type:enhancement
- Vorherrschende Sprache
- C#
- Sterne
- 240
- Forks
- 70
- Ø Merge
- 7 Std. 59 Min.
- Gemergte PRs (30 T.)
- 13
Beschreibung
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.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit der Überprüfung der Generierung des Collection-Response-Schemas und der OpenAPI 3.1-Unterstützung des Repositorys. Definiere die generischen Collection-Basistypen und das Verhalten von dynamicRef und überprüfe anschließend, dass das generierte Dokument die vielen ressourcenspezifischen Collection-Schemas nicht mehr benötigt.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- csharp
- Bereich
- api
- Issue-Typ
- Feature
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 30/100