microsoft / microsoft/sqlmanagementobjects
XML documentation for SMO objects should have content from the strings files
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- C#
- Sterne
- 143
- Forks
- 28
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Beschreibung
Today, properties created by codegen do not have proper documentation
Example:
the XML documentation file included in the nuget package lacks entries for these properties.
To improve the documentation, we should write a tool to merge the C#-generated XML file with content extracted from the SFC attributes on each facet's public properties. Those strings are currently only shown in the SSMS UI for policy-based management.
The strings reside in the strings file, eg:
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
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 damit zu untersuchen, wie codegen die XML-Dokumentation erzeugt und wie SFC-Attribute für öffentliche Facet-Eigenschaften definiert werden. Lies den im Issue referenzierten Eintrag in Smo/LocalizableResources.strings und verfolge, wie diese Zeichenfolgen für SSMS verfügbar gemacht werden. Als erledigt gilt die Aufgabe, wenn ein Tool das erzeugte XML mit der extrahierten Eigenschaftsdokumentation zusammenführt, sodass das NuGet XML Einträge für erzeugte Eigenschaften enthält.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- csharp
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 35/100