Discussion :

[oodini]

Bonjour,

En entreprise, notre cerveau est accaparé par une multitude de connaissances diverses et variées que nous aimerions mettre de côté :

• astuces de codage
• commandes Git
• commandes Bash
• processus divers
• procédures de débogage dans une architecture complexe
• connaissances propres à une entreprise (outils internes, processus, archi...)
• ...

On peut ajouter toutes ces bribes d'informations qu'on vous transmet oralement ou par chat, mais dont vous avez régulièrement besoin, et que vous oubliez tout aussi régulièrement.

Bref, je suis sûr que chacun pourrait rajouter des choses à cette liste (d'ailleurs, ne vous gênez pas : je mettrai à jour la liste).

La question est : comment capitalisez-vous ces connaissances indispensables à la tenue de votre poste, sans avoir une montagne de Post It ?

Dans le cas des développeurs indépendants, cela est encore plus critique : la commutation de contexte est fréquente, et si vous revenez dans une entreprise à plusieurs mois d'intervalle, avoir mis ces connaissances de côté est précieux.

[Pyramidev]

Pour les connaissances spécifiques à une entreprise donnée :
Le meilleur endroit, idéalement, c'est la documentation interne de l'entreprise.
Quand une information y est déjà documentée, il suffit de retenir où se trouve l'information pour pouvoir la relire le jour où on l'oubliera.
Quand je veux garder une trace d'une information qui n'est pas déjà dans la doc, je l'ajoute à cette doc. Au moins, il n'y a pas qu'à moi qu'elle servira !
Si ladite documentation n'existe pas encore, il faut la créer.

Pour les informations non spécifiques à une entreprise donnée, j'ai :

• quelques liens internet que je garde en mémoire (typiquement des liens vers de la documentation)
• quelques documents textes persos, dont la plupart sont des ensembles de liens internet classés que je ne garde pas en mémoire
• un peu de code perso

[oodini]

Malheureusement, dans la boîte où je me trouve, tout le monde dit que la doc ne sert à rien (alors que je milite pour en faire !), mais chacun fait la sienne dans son coin...

Un de mes collègues se fait une doc RST qu'il pose sur un serveur Redmine...

Mais je me demandais s'il existait des solutions toutes faites pour ce besoin.
Et je m'interrogeais par ailleurs sur les pratique de chacun.

[Hizin]

Les boîtes où je suis passé avait un wiki en place, que ce soit une solution interne ou une existante.
La plus complète que j'ai vu était sous un Confluence, avec toutes les données qu'il fallait :

• sections pour développeurs : logiciels, bonnes pratiques, nouveaux arrivants...
• commerciaux : "ressources dispo", portfolio, savoir-faire, portefeuille client...
• graphiste : essai, banque de données & leurs accès, idées, logiciels...
• chef de projet : suivi client & projet, comptes divers et variés, process...

Pour chaque projet, par contre, c'était au bon vouloir des personnes travaillant dessus. Certains étaient très complet avec les marches à suivre, explications succinctes de l'architecture, de certains choix, d'un historique client, des bugs et problèmes rencontrés en prod... D'autres n'avaient que les identifiants des comptes et les informations client sommaire...
C'était à peu près bien organisé (mais un sacré foutoir quand même... avec plus de 80 personnes, et énormément de projets, c'est pas étonnant) et chacun avait quartier libre pour organiser son espace comme il le sentait.

Mon point de vue actuel : les doc' communautaires sont les meilleures, et avoir une doc succincte sur l'historique, avec les informations client (compte, machine, date des certificats...), ça sauve des projets

[oodini]

Les boîtes où je suis passé avait un wiki en place, que ce soit une solution interne ou une existante.
La plus complète que j'ai vu était sous un Confluence, avec toutes les données qu'il fallait : [list]
(...)
Pour chaque projet, par contre, c'était au bon vouloir des personnes travaillant dessus. Certains étaient très complet (...)... D'autres n'avaient que les identifiants des comptes et les informations client sommaire...

Je me trouve dans une telle boîte (avec 130 personnes) dotée de Confluence. Sauf que mon équipe n'est malheureusement pas très encline à l'utiliser.
Comme je l'ai dit, chacun se fait sa doc, forcément sur des solutions bricolées.
Comme je me suis résolu à faire pareil (notamment pour des connaissances non spécifiques à une entreprise), je me demandais donc s'il existait des outils pour cela.

[Luckyluke34]

J'ai pas mal utilisé OneNote dans plusieurs boîtes. Le côté collaboratif et "free form" est assez efficace, l'outil est intuitif et ne se met pas en travers du chemin. Bien sûr ça demande d'un autre côté de l'organisation pour bien structurer la base de connaissances en projets, rubriques, etc.

[Marco46]

En ce qui me concerne je mets à jour régulièrement un repo git dédié sur github. Evidemment je ne mets rien du tout qui concerne directement un process interne d'un client. Par contre j'y prends plein de notes et de référence concernant mon métier de développeur. Ca fait quelques années que je fais ça et ça m'est devenu absolument indispensable. Ca m'a permis de beaucoup gagner en efficacité. Il m'arrive de rentrer dans une mission où on me demande l'écriture d'un doc sur tel ou tel sujet et je n'ai quasiment plus qu'à copier / coller retoucher légèrement un de mes documents de notes.

Pour ce qui est des process internes là aussi je prends des notes à peu près de la même manière, l'endroit où je stocke ces notes dépends de l'infra de l'entreprise (confluence, mails, répertoire réseau, ...)

Et enfin il y a le code source des projets, où je place régulièrement des fichiers markdown aux bons endroits sur des sujets précis.