Around and About .NET World

Il blog di Marco Minerva
posts - 1671, comments - 2232, trackbacks - 2135

My Links

News

Contattami su Live Messenger:


MCTS: Windows, Web, Distributed Applications & SQL Server

MCPD: Enterprise Applications

Tag Cloud

Archives

Post Categories

Links

[70-549] Un libro pieno di verità

Il Self-Paced Training Kit per l'esame 70-549 è veramente ricco di verità universali... Dopo quella sulla richiesta di memoria delle applicazioni Microsoft, ne ho scovata un'altra relativa alla voglia che gli sviluppatori hanno di documentare il proprio codice:

Getting developers to document their code is just as easy as getting children to eat their vegetables when their dessert is sitting in front of them.

Credo proprio che scrivere la documentazione del codice sia la croce di ogni programmatore...

Technorati Tag:

Print | posted on Monday, February 25, 2008 2:58 PM | Filed Under [ Certificazioni ]

Feedback

Gravatar

# re: [70-549] Un libro pieno di verità

Eh Marco, porca paletta, se pero' ogni Dev documentasse decentemente, ci sarebbero meno grattacapi. Mi ci metto anche io dentro questa categoria, bisognerà fare un fioretto per Pasqua.
:-D
2/25/2008 3:06 PM | raffaeu
Gravatar

# re: [70-549] Un libro pieno di verità

Capisco bene quello che dici... Anch'io cerco di documentare il mio codice il più possibile... Ma la voglia è sempre poca :-D
2/25/2008 3:10 PM | Marco Minerva
Gravatar

# re: [70-549] Un libro pieno di verità

Mah, io commento VERAMENTE molto poco per scelta metodologica.
Cerco sempre (poi probabilmente non sempre riesco, che è differente...) di scrivere codice in modo talmente esplicito che non ci sia bisogno di commenti.

Solo nei casi in cui il nome metodo diventa un papiro inserisco una SummaryDescription, ma all'interno del metodo, se sento la necessità di un commento la interpreto come uno "smell" e controllo se è il caso di fare del refactoring.

Differente il discorso sui TODO, quelli li uso in abbondanza perchè sono veramente troppo comodi in VS. ;-)

Ciao!
2/27/2008 2:12 PM | Mario Duzioni
Gravatar

# re: [70-549] Un libro pieno di verità

Capisco quello che dici... Però se sviluppi una libreria che deve essere usata da terzi, allora la documentazione dei metodi e dei parametri ritengo sia fondamentale. Personalmente sono dell'idea che la una buona libreria è tale se è ben documentata.
2/27/2008 2:24 PM | Marco Minerva
Gravatar

# re: [70-549] Un libro pieno di verità

A mio parere il discorso commenti è vario ed importante. Ci sono:
1) i commenti per se stessi a livello di riga - blocco ecc.
2) i commenti da esporre al client successivo che utilizza l'attuale codice
3) documentazione del lavoro: architetture, strati, scelte, viste ecc.
Non riesco mai a documentare il necessario in modo completo come vorrei, ma sarebbe molto utile. Quando riprendo in mano (per mille motivi) un progetto, un modulo, una libreria, delle routine ecc. più tempo è passato meno ricordo cosa fà, perchè ho fatto in un modo e non in un altro ecc. ... se ho documentazione però recupero il ragionamento complessivo e di dettaglio molto più velocemente ed efficacemente
Ciao Marco, ci siamo conosciuti a Genova per un colloquio di lavoro. In bocca la lupo per il nuovo lavoro fiorentino

2/28/2008 10:14 AM | Alessandro
Gravatar

# re: [70-549] Un libro pieno di verità

Ciao Alessandro! Mi ricordo di te! Grazie per il commento, crepi il lupo!
2/28/2008 11:34 AM | Marco Minerva
Comments have been closed on this topic.

Powered by:
Powered By Subtext Powered By ASP.NET