Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Automatically add boilerplate summary for auto-added parameterless constructors

Aperta
#132 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
csharp

Direzione di ricerca

Confronta le voci generate di runtime\artifacts\bin\System.ComponentModel.TypeConverter\Release\net7.0\System.ComponentModel.TypeConverter.xml con i file XML corrispondenti di dotnet-api-docs per HalfConverter, Int128Converter e UInt128Converter. Verifica se i costruttori senza parametri sono generati dal compilatore o mancano a causa dell’artifacts path, quindi esamina il comportamento di sincronizzazione e concorda un riepilogo generico. Il lavoro è concluso quando la causa è stata stabilita e sono stati definiti il trattamento del boilerplate e la formulazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

port-to-docs

HalfConverter, Int128Converter or UInt128Converter, have their documentation xml file created in this location:

runtime\artifacts\bin\System.ComponentModel.TypeConverter\Release\net7.0\System.ComponentModel.TypeConverter.xml

None of these 3 APIs have an xml entry for a parameterless constructor, but it gets added to the dotnet-api-docs file automatically anyway. According to this programming guide doc, it's valid.

To fix this:

  • We need to agree on a generic boilerplate message that would apply to all APIs. Something like:

Creates a new <see cref=”T:Full.Name.Of.Type”/> instance with default values.

  • We need investigate if it’s possible to determine if a parameterless constructor was autogenerated by the compiler and that’s why I was unable to find its docs in the intellisense xml files, or if the problem was that the user provided the wrong artifacts path which does not contain the xml file with that type’s docs.
Lingua principale
C#
Stelle
14
Fork
22
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di dotnet/api-docs-sync

Tutte le issue di dotnet/api-docs-sync

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.