Domande con tag 'comments'

23
risposte

Come posso trattare con un membro del team che non ama fare commenti nel codice?

Uno dei membri del mio team evita costantemente di inserire commenti nel suo codice. Il suo codice non è auto-documentante, e altri programmatori hanno difficoltà a capire il suo codice. Gli ho chiesto più volte di commentare il suo codice...
posta 14.02.2013 - 22:45
0
risposte

"I commenti sono un odore di codice" [chiuso]

Un mio collega crede che qualsiasi uso di commenti in-code (cioè, non metodo javadoc o commenti di classe) sia un codice odore . Cosa ne pensi?     
posta 25.11.2011 - 23:32
12
risposte

Il mio cliente desidera il 25% dei commenti nel mio progetto corrente, come reagire? [chiuso]

sviluppatore junior qui. Attualmente sto lavorando da solo su un'applicazione web per un grande cliente della mia azienda. Ho iniziato il mese scorso. Il cliente desidera almeno il 25% dei commenti in ciascuno dei suoi progetti software. H...
posta 05.03.2018 - 22:52
9
risposte

Pulisci i commenti del codice e la documentazione della classe

Sto discutendo con i miei nuovi colleghi di discussioni. Entrambi amiamo Pulisci codice e sto perfettamente bene con il fatto che in linea i commenti sul codice dovrebbero essere evitati e i nomi delle classi e dei metodi dovrebbero essere u...
posta 04.06.2015 - 10:30
22
risposte

Come faccio a convincere i miei colleghi sviluppatori a VOGLIA di aggiungere commenti al codice sorgente commesso?

So che Subversion (quello che stiamo usando al lavoro) può essere configurato per richiedere commenti sui commit, tuttavia non sono in grado di accenderlo semplicemente. So che il mio motivo per commentare i miei commit è perché è utile, se no...
posta 20.09.2011 - 15:24
13
risposte

Quali sono gli esempi di commenti che ti dicono perché invece di come o cosa? [chiuso]

Prima di tutto, in questa domanda mi piacerebbe stare lontano dalla polemica sul fatto che i commenti sul codice sorgente siano buoni o cattivi. Sto solo cercando di capire più chiaramente cosa intendono le persone quando parlano di commenti che...
posta 09.08.2013 - 08:51
16
risposte

Cosa c'è di sbagliato nei commenti che spiegano codice complesso?

Un sacco di persone sostengono che "i commenti dovrebbero spiegare" perché ", ma non" come "". Altri dicono che "il codice dovrebbe essere auto-documentante" ei commenti dovrebbero essere scarsi. Robert C. Martin afferma che (riformulato secondo...
posta 01.09.2014 - 02:28
17
risposte

Come posso chiedere al mio capo (in modo educato) di commentare il suo codice?

Mi è stato insegnato dal mio capo (ho appena finito la scuola e voleva qualcuno con una piccola esperienza di programmazione, così ha scelto me per insegnarmi su cosa sia specializzata in quella società) e ha iniziato a lavorare con ASP.NET MVC...
posta 09.02.2015 - 10:01
17
risposte

I commenti di TODO hanno senso? [chiuso]

Sto lavorando a un progetto abbastanza grande e ho avuto l'incarico di fare alcune traduzioni per questo. C'erano tonnellate di etichette che non sono state tradotte e mentre stavo scavando attraverso il codice ho trovato questo piccolo pezzo di...
posta 11.11.2013 - 10:46
13
risposte

Il codice commentato può essere una documentazione preziosa?

Ho scritto il seguente codice: if (boutique == null) { boutique = new Boutique(); boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL...
posta 11.03.2013 - 10:36