Domande con tag 'comments'

domande con tag
5
risposte

Come vengono solitamente analizzati i commenti?

In che modo i commenti vengono generalmente trattati nei linguaggi di programmazione e nel markup? Sto scrivendo un parser per un linguaggio di markup personalizzato e voglio seguire il principio di sorpresa minima , quindi sto provando a deter...
posta 29.10.2015 - 17:35
13
risposte

Commento prima o dopo il codice pertinente [chiuso]

Supponendo che un commento non vada bene (o non possa andare) sulla riga a cui si applica, dovrebbe scrivere il commento prima del codice o dopo? Bene, ovunque i futuri lettori capiranno meglio l'ambito del commento. In altre parole, ovunque...
posta 22.12.2011 - 19:21
8
risposte

buona sostituzione per commentare il codice? [duplicare]

Mi dà fastidio vedere il codice commentato e sembra spesso, a volte un sintomo di sviluppatori che non sono abili nelle funzioni avanzate di controllo del codice sorgente, ma d'altra parte il controllo del codice sorgente non risolve completam...
posta 07.10.2013 - 23:41
7
risposte

Si dovrebbe commentare in modo diverso nelle lingue funzionali? [chiuso]

Ho appena iniziato con la programmazione funzionale e mi sto chiedendo quale sia il modo corretto di commentare il mio codice. Sembra un po 'ridondante commentare una breve funzione dato che i nomi e la firma dovrebbero già dirti tutto quello...
posta 17.11.2011 - 12:22
6
risposte

Guida per principianti per scrivere commenti?

Esiste una guida definitiva alla scrittura di commenti sul codice, rivolta agli sviluppatori in erba? Idealmente, coprirebbe quando i commenti dovrebbero (e non dovrebbero) essere usati, e quali commenti dovrebbero contenere. Questa rispo...
posta 14.11.2011 - 05:47
6
risposte

Spiegazione della sintassi nuova o non comune nei commenti [duplicato]

Come per il titolo, dovrei spiegare la sintassi che uso nel mio codice quando ho una ragionevole aspettativa che uno sviluppatore che guarda il mio codice in futuro non lo conosca? Breve avvertimenti o spiegazioni potrebbero essere aggiunti...
posta 26.08.2015 - 11:27
5
risposte

Come risolvere il problema dei commenti annidati

Appare non solo in una lingua che i commenti non possono essere annidati. Hai una buona soluzione per questo problema? Una soluzione alternativa in C / C ++ e Java è utilizzare solo il commento a riga singola, ma diventa impossibile quindi comme...
posta 13.06.2013 - 08:32
21
risposta

Codice autodidattico vs. Codice commentato

Ho effettuato una ricerca ma non ho trovato quello che stavo cercando, non esitate a collegarmi se questa domanda è già stata fatta. All'inizio del mese questo post è stato realizzato: link Fondamentalmente per riassumere, sei un prog...
posta 24.02.2011 - 11:17
8
risposte

I commenti dovrebbero dire PERCHÉ il programma sta facendo quello che sta facendo? (opinione su un motto dell'inventore di Forth) [duplicato]

Il spesso provocatorio Chuck Moore (inventore del Avanti lingua) ha dato il seguente consiglio [1] : Use comments sparingly! (I bet that's welcome.) Remember that program you looked through - the one with all the comments? How help...
posta 31.10.2012 - 22:56
6
risposte

Le migliori pratiche nella scrittura e nella documentazione dei commenti

Commentare oggi è più facile che mai. In Java, ci sono alcune buone tecniche per il collegamento dei commenti alle classi e gli IDE Java sono utili per creare shell di commenti per te. Lingue come Clojure consentono persino di aggiungere una des...
posta 29.12.2011 - 01:06