Chaque programmeur devrait-il tenir un journal des «leçons apprises»? [fermé]


12

Chaque fois que j'ai terminé un projet, il y a toujours quelque chose que j'ai appris (sinon je ne trouve pas ça très motivant). Mais je ne me souviens pas de tout, et bien plus tard, je peux tomber sur le même problème que j'ai rencontré dans un projet précédent, mais plus comment je l'ai résolu (ou du moins quelles tentatives j'ai faites).

Serait-ce donc une bonne idée d'écrire cela dans un journal quelconque? Je sais qu'écrire des choses, c'est comme écrire de la documentation (ce que tout le monde n'aime pas faire), et j'espère que notre mémoire nous servira en cas de besoin. Mais après l'avoir documenté, il pourrait être partagé avec d'autres programmeurs et apprendre quelles leçons ils ont apprises.

Alors, qu'est-ce que tu penses?

Réponses:


9

Le blog technique serait un excellent choix ici pour obtenir une expérience consolidée. Même cela aidera les autres à travers le monde à apprendre de vos erreurs :)


Je tiens un blog sur les leçons apprises (allez ici -> teadrinkinggeek.wordpress.com ), et cela vous aide (1) à vous récompenser pour ce que vous avez appris (2) à regarder ce que vous avez appris au fil du temps.
TeaDrinkingGeek

2
@TeaDrinkingGeek: vous pouvez incorporer des liens dans les commentaires en utilisant la [visible text](http://url.to/page)syntaxe;) Comme ceci
Konerak

6

Cela semble être une bonne idée de revoir ce qui a été fait à la fin du projet et les problèmes rencontrés, et de voir ce qui a causé ces problèmes et comment les éviter. La rédiger dans un journal est également une bonne idée, car elle facilite le rappel et évite les mêmes problèmes plus tard.

Le partage, en revanche, doit se faire avec prudence. Bien sûr, cela est utile pour d'autres développeurs et chefs de projet, mais si vous travaillez avec des clients et que ces clients peuvent lire sur les problèmes que vous avez rencontrés dans le passé, ils seront moins enclins à commencer / continuer à travailler avec vous, car:

  • Ils sentiront que vous rencontrez plus de problèmes avec les projets que les autres (même si c'est faux),
  • Ils ne veulent pas que vous publiez des informations sur les éventuels problèmes rencontrés dans leurs projets.

Je crois que cela s'appelle normalement une analyse post mortem. Cela se fait (afair) lorsque la période de support est terminée et que le produit est pratiquement mort et n'est plus pris en charge.
Bjarke Freund-Hansen

3

J'ai un journal Elder Scrollsy où j'écris des choses chaque fois que j'apprends quelque chose de nouveau. Comme vous pouvez l'imaginer, c'est devenu assez gros et plein d'informations.

En fait, j'ai pensé à créer un logiciel qui me permet simplement d'écrire des notes et de marquer les notes de la même manière que les sites SE font des questions.

Je pourrais:

  • Rechercher des messages par date.
  • Rechercher des messages par balises.
  • Rechercher des messages par difficulté.

Ce serait vraiment utile pour moi.


Blogspot ne le fait-il pas déjà?
Vinoth Kumar CM

Je suppose que si vous voulez quelque chose d'aussi gros, vous pouvez également l'utiliser.

3

J'ai essayé une fois, avec un journal quotidien des choses que j'avais faites, réfléchissant à ce qui aurait pu mieux se passer et à ce que je devrais essayer la prochaine fois. Ce n'était pas des trucs techniques - il s'agissait d'interactions avec d'autres personnes de l'équipe, de décisions prises lors de réunions, etc. (oui, cette entreprise avait suffisamment de réunions que j'avais quelque chose à écrire tous les jours!).

J'ai finalement trouvé que le journal était une mémoire en écriture seule: peut-être que l'expérience de l'écrire m'a aidé à organiser mes pensées ou à évaluer ce que j'avais fait, mais j'ai découvert après environ six semaines que je n'avais jamais retourné en arrière et passé en revue ce que j'avais écrit alors j'ai arrêté de le garder.

En ce qui concerne les notes techniques, je ne les garde pas vraiment sauf si je dois me présenter à une conférence ou à un client. Sinon, un ensemble de signets dans Pinboard.in me suffit.


2

Absolument, il faut tenir un journal des leçons apprises et des leçons apprises. Le premier consolide le type d'apprentissage le plus cher, acquis par l'expérience directe. Ce dernier nécessite / stimule un apprentissage proactif, ce qui est nécessaire pour ne pas aspirer.

La journalisation est l'un des plus anciens outils d'auto-développement connus, et elle invite à (l'auto) réflexion, qui est une méthode encore plus ancienne. Il faut les deux.


1

Absolument. Histoire vraie: Peu de temps après avoir lu cette question, je suis tombé sur un problème que je savais avoir résolu auparavant (un problème de configuration, si cela est important). J'ai parcouru mon cahier «Leçons apprises» (édition papier et stylo), et il y avait la solution: copier le fichier a vers l'emplacement b.

Ce cahier m'aide de deux manières: premièrement, en fournissant un endroit pour trouver des réponses aux questions posées précédemment et aux problèmes résolus, et deuxièmement en renforçant les connaissances en les écrivant (un peu comme l'expliquer à quelqu'un d'autre).

Bien sûr, je perds de temps en temps ledit carnet ...


0

C'est à cela que sert un système de gestion de projet / problème, comme TRAC, Jira, ou ce que vous avez. Au travail, je mets des commentaires détaillés, des procédures, des dépendances dans notre TRAC et Jira et pour que lorsque nous sommes confrontés à un problème déjà vu, une simple recherche nous donne la réponse.

En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.