Je réfléchissais tout haut, pendant que mes doigts ce battaient sur mon clavier:
"Qu'elle est la tâche plus pénible pour un développeur ? Faire du Microsoft Word dans la doc ? Ou faire une application en la reprenant ? Je crois que c'est ni l'un ni l'autre, le trippeux technique, le codeur, le g33k, le vrai développeur préfaire ni l'un ni l'autre. Et pourtant..."
"... avec le temps, les projets, les mandats, personnelement, j'aime mieux prendre le temps de documenter, revoir, comprendre ce que j'ai pu faire et le mettre par écrit, que de reprendre le même projet six mois plus tard... et ne pas trop savoir quoi mettre sur mes toasts."
"Ne pas trop savoir quoi ? Le pourquoi du comment de la contrainte du département X à cause du facteur Y. Vous savez, ce fameux cas spécial qui n'avait pas été décrit dans la spécification fonctionnel, ce "if" plugué, caché par une pile de commentaires du genre..."
/******** FIX FOR MARKETING *************/
/******** DO NOT REMOVE ****************/
/******** HACK **************************/
/**** MORE DETAILS: ASK TO gbill@invalidHost.com **/
if([Condition == ISOTERIQUE]) {
// HACK: Patch for Marketing Department
Response.Redirect("default_specialPage.aspx");
} else {
// TODO: Implement the regular code here
throw new NotImplementedException("HO SHIT");
}
/******* END OF F*C*K*N* Marketing HACK****/
"Soit causé par la phrase... "je manque de temps" ou "j'ai pas le temps", ou... "oups, j'ai fais ça moi ? C'est pas ma faute" !""J'exagère quand même un peu la situation, mais il est vrai que souvent, on ne prend pas assez de temps pour documenter, autant les codes sources, documents technique et le fonctionnement même de l'application, soit ses dépendances vis-à-vis les versions des composants utilisés.""Dans d'autre situation on préfère dire que l'on adère à une méthodologie de travail afin de ce défendre de ne pas documenter, autant le code, que faire des documents fonctionnel et technique... C'est selon moi une manière de dire que l'on ne sait pas ce que l'on fait, tout simplement...""Bon ok, j'entends déjà râler... ça sert a rien de documenter le code source. Minute, trop document ça sert à rien, mais simplement pouvoir répondre à "La classe B fait quoi ?", "Pourquoi on doit s'attendre d'obtenir une System.TimeoutException de la méthode Connect ?". La réponse est là... c'est ça qu'il faut savoir documenter.""Personnelement, je ne sais pas faire de documentation, je ne m'en cacherai pas... Je documente VRAIMENT depuis peu, car lorsqu'au étude on nous fesais sur-documenter... dans les premières années de travail, pas de documentation... ou très peu... C'est toujours de nouvelles approches différentes dans tout les milieux, alors on ne sais jamais vraiment faire, résultat... sur ou sous documentation."
"Bref, les avantages sont là... je n'apprends rien à personne. Dans six mois, lorsque je vais reprendre ce projet, je sens que je vais mieux me souvenir et comprendre comme au premier jour... plutôt que d'avoir le réflex de dire:" "C'est de la merde ce truc, qui à fait ça ?"
Le collègue: "Heu, c'est toi Louis !"Oups, faite ce que je dis, pas ce que je fais ;)
Soyez le premier à noter ce billet
- Currently 0/5 Stars.
- 1
- 2
- 3
- 4
- 5