Domande con tag 'comments'

domande con tag
4
risposte

Correggere l'allineamento durante il codice in uscita

Supponiamo di avere del codice void some_block(void) { some_statement_1(); some_statement_2(); some_statement_3(); } Ora desidero commentare l'affermazione n. 2, ma qui non riesco mai a trovare un modo in cui sia giusto. Di soli...
posta 01.12.2010 - 14:08
6
risposte

Quanto commento è meglio per la codifica? [duplicare]

Non ho un'educazione informatica formale, il che significa che non ho studiato argomenti di informatica in un'università. Tuttavia, lavoro in un lavoro di programmazione e scrivo una quantità ragionevole di codice. Naturalmente, la programmazi...
posta 28.04.2016 - 16:33
3
risposte

"Commenta tutto nel modo giusto" e "Invece di scrivere commenti, scrivi codice più leggibile." - Entrambe le strategie valide?

Quando ho provato a conoscere le pratiche di commento corrette, ho trovato molte opinioni contrastanti ed è ovviamente un argomento molto soggettivo. Quindi non ho intenzione di chiedere "Dovrei commentare, o non dovrei?" La domanda che vorre...
posta 07.11.2016 - 07:38
2
risposte

Cosa ha dimostrato la ricerca sull'efficacia dei commenti?

Ho discusso con un amico sulla necessità di commenti e sull'efficienza dei diversi stili di commento. L'argomentazione si è conclusa abbastanza velocemente, in quanto non è stato possibile trovare alcuna ricerca - o saggio - a supporto di entram...
posta 23.02.2012 - 17:24
2
risposte

come pluralizzare i termini "speciali", ad es. nomi di classe

Molto spesso mi trovo a riferire nel testo a oggetti che hanno severe convenzioni di denominazione, ad es. Oggetti, processi, servizi Java. Mi trovo in un dilemma su come pluralizzare questi nomi. Sembra sbagliato inquinare il nome significat...
posta 07.08.2013 - 10:41
7
risposte

È sbagliato non creare Javadoc per il mio codice?

Faccio molta programmazione Java al mio lavoro (sono uno stagista) e mi chiedevo se generalmente è una regola creare javadoc per accompagnare il mio codice. Di solito documento comunque ogni metodo e classe, ma trovo difficile aderire alla sinta...
posta 21.06.2011 - 20:01
7
risposte

In quale fase dello sviluppo dovrebbero essere scritti i commenti?

Sono uno studente che sta facendo uno stage in un'azienda più grande, scrivendo app per piccole imprese in C #. Ho notato che non commento il mio codice mentre lo scrivo. Piuttosto, commento il mio codice quando sono nella fase di sviluppo del d...
posta 19.11.2012 - 19:54
5
risposte

Documentare le decisioni di progettazione nei commenti di codice?

Come posso documentare al meglio una decisione sul design del codice nel mio codice sorgente? Dovrei semplicemente aggiungere un grosso commento in un punto che ritengo giusto? O dovrei semplicemente creare un file separato? Questo problem...
posta 10.04.2018 - 18:44
15
risposte

Cosa ne pensi dell'apertura di commenti di parentesi nel codice sorgente? [chiuso]

Ho sviluppato l'abitudine di scrivere commenti nel mio codice mettendo i commenti sulla stessa riga del tutore di apertura, dopo la parentesi graffa. Ho scoperto che questo consente di risparmiare spazio verticale. Lascia anche un suggerimento s...
posta 29.08.2011 - 15:09
2
risposte

Documenta l'effetto di std :: move

Mentre la mia squadra progredisce verso l'adozione delle nuove funzionalità in C ++ 11, sto cercando di rendere effettivi gli effetti collaterali di std::move di auto-documentazione nel codice. Il problema è che un oggetto che è stato sp...
posta 25.11.2013 - 11:51