Commentate, qualcosa resterà

Sto cercando di lobotomizzare un programma per avere un “piano B” pronto nel caso non riesca a fare in tempo la nuova versione, e quindi mi sto avventurando in meandri di codice stratificati nel tempo da schiere di ignoti programmatori – il tutto naturalmente senza alcuna documentazione, secondo il famoso detto “basta leggere il sorgente”.
Trovata una chiamata a una funzione che dovrei eliminare, vedo che uno dei parametri di chiamata ha vicino un commento. Eccolo:
/* So che qualcuno chiederà: perché questo???? */
Aveva ragione.

Ultimo aggiornamento: 2003-10-30 18:04

2 pensieri su “Commentate, qualcosa resterà

  1. Fabrizio

    Per piu’ o meno 6 mesi,subito dopo il diploma, ho fatto di mestiere il “commentatore di sorgenti”, mi veniva passato un modulo continuo e io dovevo capirlo e commentarlo. Il passo dopo sarebbe stato quello di riscrivere alcuni pezzi di codice, tutto su carta.

  2. domenico

    Bellissimo link a questo proposito:
    “How to write Unmaintainable Code”
    http://mindprod.com/unmain.html
    Ci sono alcuni trucchetti davvero subdoli per incasinare la vita a chi dovrà leggere il codice in futuro :)
    Questo per esempio mi fa impazzire:
    CAMOUFLAGE
    Long Similar Variable Names : Use very long variable names or class names that differ from each other by only one character, or only in upper/lower case. An ideal variable name pair is swimmer and swimner.

I commenti sono chiusi.