Visual Studio: Missing XML comment for publicly visible type or member…

Sto partecipando allo sviluppo del nuovo MES da utilizzare nell’azienda nella quale lavoro. Volendo pian piano documentare per lo meno il dominio abbiamo attivato la compilazione delle References.

Questo ha però portato al problema opposto: tutte le funzioni non ancora commentate emettono un warning del tipo:

Missing XML comment for publicly visible type or member […]

Dopo un veloce giro in rete ho trovato queste possibilità:

  1. 1. Completare la fase di documentazione (non attuabile al momento)
  2. 2. Disabilitare la generazione della documentazione (un peccato per il lavoro già fatto ed uno sprono a completarlo)
  3. 3. Disabilitare i warning di questo tipo (1591)
  4. 4. Usare “#pragma warning disable 1591” e#pragma warning restore 1591” all’inizio e alla fine del codice da escludere (non pratico nel caso di un dominio con tante classi)
  5. 5. Ignorare i Warnings (cattiva idea, perché qualche warning è invece interessate)

Se avete il mio stesso problema consiglio il metodo 3, andando sull’apposito tab del progetto.

image

«gennaio»
domlunmarmergiovensab
2627282930311
2345678
9101112131415
16171819202122
23242526272829
303112345