Domande con tag 'comments'

4
risposte

Come fa un codice sviluppatore in previsione del cambiamento? [chiuso]

Faccio questa domanda basandomi sul fatto che attualmente il mio ambiente è in costante cambiamento a causa del tipo di lavoro che svolgiamo. Non sempre lavoriamo su basi di progetto, spesso abbiamo modifiche più piccole che passano attraverso u...
posta 08.01.2015 - 05:50
3
risposte

Dovrebbe // indicato // quando e // quindi i commenti saranno inclusi nei test unitari?

Sono entrato a far parte di un nuovo team di grandi colleghi ed è emersa una divergenza di opinioni riguardo l'inclusione di //given //when e //then blocchi di commento nei test unitari. Ad esempio public void mapToitemList_M...
posta 09.03.2018 - 14:20
3
risposte

Come si pluralizza vedere cref="Notazione"?

Qual è il modo più appropriato di scrivere questo commento: /// <summary> /// Order - Identifies the ordinal location of this category /// relative to other listed categories. /// </summary> se voglio racchiu...
posta 16.02.2011 - 19:48
3
risposte

È fuorviante etichettare il codice come un particolare modello di progettazione se solo si adatta alla definizione in modo approssimativo?

Sfondo: Ho una comprensione approssimativa, ma di lavoro dei ~ 15 schemi di progettazione. È stata la mia esperienza nell'uso di modelli di progettazione nei miei progetti che le implementazioni risultanti di solito finiscono come alcune v...
posta 13.12.2014 - 17:27
2
risposte

Con quale frequenza vengono utilizzati i commenti nei documenti XML?

Al momento sto sviluppando un programma di gestione XML basato sul web per un cliente (anche se potrei "commercializzarlo" per i futuri clienti). Attualmente legge un documento XML, lo converte in oggetti Javascript gestibili e alla fine sputa c...
posta 19.03.2012 - 17:30
1
risposta

Esiste uno standard di settore per strutturare codice e commenti?

Ho lavorato con un certo numero di team di professionisti e sembra che la struttura del codice di classe varia da altamente organizzata a completamente disordinata. Ho fatto recentemente un progetto con lo stato della California e hanno richiest...
posta 28.10.2011 - 19:36
7
risposte

Dovresti usare "abbreviazioni interne" nei commenti al codice? [chiuso]

Se dovessi usare "abbreviazioni / gergo interno" all'interno dei commenti, cioè le abbreviazioni e le gergali al di fuori del progetto potrebbero avere problemi a capire, ad esempio, usando qualcosa come //NYI invece di //Not Yet Implemen...
posta 11.04.2011 - 22:34
6
risposte

Non dovremmo contare i caratteri di codice e commenti invece delle righe di codice e commenti? [chiuso]

Il conteggio delle righe di codice e commenti a volte è fasullo, poiché la maggior parte di ciò che scriviamo può essere scritto in una o più righe, a seconda delle limitazioni del conteggio delle colonne, delle dimensioni dello schermo, dello s...
posta 26.10.2011 - 15:32
2
risposte

Lasciando commenti "Else"

Diciamo che ho un'istruzione non-così-intuitiva if nel mio codice, ma solo se sei nuovo alla base di codice: def set_markets(markets=None): """ Will accept 'all' as markets to set all markets on. For individual markets, pass i...
posta 04.03.2013 - 21:46
2
risposte

I commenti su più righe sono una funzione critica in un linguaggio moderno?

Sto cercando di convincere i progettisti di un linguaggio che i commenti multi-linea con un inizio e una fine arbitrari sono importanti e dovrebbero essere inclusi. Attualmente esiste solo una primitiva "comment-to-end-of-line". La loro linea...
posta 22.04.2014 - 02:59