martedì 19 aprile 2016

Sysadmin Panics: eliminare i commenti

Quando si produce del codice, in qualunque linguaggio, sia di scripting che di programmazione, i commenti rappresentano una parte fondamentale del sistema stesso. Si prenda esempio da quei progetti che non permettono a buon codice di "colpire" l'albero principale se non è opportunamente commentato e documentato.
L'idea è ovvia: anche se il codice è funzionalmente il migliore del mondo deve essere manutenibile da altre persone, che potrebbero non capire a prima vista (e anche alle viste successive!) il comportamento stesso.

Io credo, ho sempre creduto anzi, nell'importanza dei commenti nel codice, a qualunque livello.
Altri esperti non la pensano come me.
Mi è quindi capitato, mantenendo un sistema composto da diversi server, di trovare alcuni miei script modificati da un giorno all'altro. La modifica era semplice: tutti i commenti erano stati rimossi.
Motivo? Portavano via spazio!

Meglio non commentare sia l'azione che la motivazione.

Vediamo però di essere maliziosi: se si è un dipendente il costo/stipendio non viene stabilito in base al tempo nel quale si risolve un problema, e anzi si cerca di ottimizzare lo stipendio fisso risolvendo piu' problemi nello stesso tempo. E' quindi di importanza strategica la documentazione per una rapida comprensione di cosa un programma/script/task sta tentando di fare.
Se invece si è un consulente esterno, pagato a tempo, il fatto che occorra piu' tempo per leggere e comprendere un programma decommentato non è un problema per il sysadmin stesso, anzi potrebbe essere fonte di ulteriori guadagni...
Pensateci la prossima volta che vi trovate da uno dei due lati della barricata: potreste evitare figuracce o costi inutili.

2 commenti:

prestito privato ha detto...

Salve Sig.r. & Sig.ra Vi offro un prestito e d'investimento di 2.000€ a 900.000.000€ per chiunque in grado di ripagare con gli interessi al 2 a 3% per tutti e-mail a chiunque sia interessato a me. Faccio prestiti e d'investimento locali e internazionali di persone in tutto il mondo contatto con me oggi e fammi sapere quanti soldi vuoi prestare.Sono pronto ad incontrare i nostri candidati entro 24 ore dalla ricezione della richiesta forma.Alora se avete bisogno di prestito o investimento i soldi non esitate a contattarmi per ulteriori informazioni alle mie condizioni molto favorevoli.
E-MAIL: lauracredito2000@gmail.com

Mr Abdullah Ibrahim ha detto...

APPLY FOR URGENT LOAN TO HELP YOURSELF OR FAMILY PEOPLE?

Are you in need of Urgent Loan Here no collateral required all problem regarding Loan is solve between a short period of time with a low interest rate of 2% and
duration more than 20 years what are you waiting for apply now and solve your problem or start a business with Loan paying of various bills I think you have come to the right place I'll advise you can contact us via email
whatspp +917738214856
abdullahibrahimlender@gmail.com
Mr Abdullah Ibrahim