microsoft / microsoft/OpenAPI.NET

Docs to explain why behind breaking changes

Offen
#2,426 0 Kommentare 4 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

type:documentation
Vorherrschende Sprache
C#
Sterne
1.6k
Forks
286
Ø Merge
6 Std. 38 Min.
Gemergte PRs (30 T.)
35

Beschreibung

Customer request:
The OpenAPI.NET 2.0 GA will bring a lot of breaking changes and customers need to understand the "why" behind them.

Ask:
Author documentation to explain the why. We currently have an upgrade guide which show the "what" and "how" to upgrade.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Lies zunächst den vorhandenen Upgrade-Leitfaden, der abdeckt, was sich geändert hat und wie das Upgrade durchgeführt wird. Identifiziere die darin aufgeführten Breaking Changes von OpenAPI.NET 2.0 und füge anschließend eine begleitende Dokumentation hinzu, die die Gründe dafür erläutert; abgeschlossen ist die Aufgabe, wenn Kunden verstehen können, warum die Änderungen vorgenommen wurden.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
csharp, openapi
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.