- Sur des tâches qui s’étalent sur plusieurs jours, comme un problème d’autorisations dans un pipeline de déploiement, il est facile de perdre le contexte de travail au moindre message, réunion ou appel
- Le journal de travail est l’habitude de noter les commandes exécutées, les résultats, le fil de pensée et l’action suivante, et il aide à retrouver rapidement sa concentration au moment de reprendre
- Après avoir commencé à noter la situation dans les notes quotidiennes d’Obsidian sur des tâches peu documentées et difficiles à faire avancer avec les interlocuteurs concernés, il est devenu plus facile de restaurer le contexte en passant d’un travail à l’autre
- L’essentiel n’est pas de tout relire plus tard, mais de créer une structure pour organiser sa pensée et un cache pour sauvegarder le dernier état
- Si votre concentration est souvent interrompue, laisser une courte note sur ce que vous faites et la prochaine action, puis relire les dernières phrases à votre retour, peut réduire le coût du changement de contexte
Le moment où le contexte de travail se rompt
- Quand on est absorbé depuis plusieurs jours par une tâche complexe, il faut garder en tête en permanence le fil de résolution du problème tout en naviguant entre plusieurs onglets de documentation et les résultats d’exécution de commandes
- Une simple interruption, comme une notification IM, une demande de document d’un PM ou un appel du manager, suffit souvent à faire perdre sa position actuelle
- Il était particulièrement difficile de rester concentré lorsqu’il fallait changer de contexte toute la journée en tant que manager, ou gérer en parallèle plusieurs projets qui entraient en conflit en tant que développeur
- Le schéma courant consiste à commencer une tâche, basculer vers une autre, entrer en réunion, puis finir la journée à lire des e-mails et des messages IM en ayant oublié la nature même du travail initial
La méthode du journal de travail et ses effets
- En travaillant sur des tâches sans documentation et pour lesquelles il était difficile de joindre les personnes précédemment en charge, l’auteur a commencé à consigner sa frustration dans les notes quotidiennes d’Obsidian
- Il a ensuite noté ensemble les commandes exécutées et leurs résultats, le fil de pensée, ce qu’il était en train de faire et ce qu’il comptait faire ensuite
- Par exemple, il notait une commande comme
--yo-compress-shit really-well-like-5000-or-somethingainsi que l’erreur d’échec obtenue - Après une interruption, il relisait ses notes et revenait rapidement à la tâche d’origine
- Par exemple, il notait une commande comme
- Après avoir utilisé cette méthode de façon continue pendant les 3 à 4 derniers mois, il a eu le sentiment que la restauration du contexte était devenue beaucoup plus rapide lors du passage d’une tâche à l’autre
- Un journal de travail n’est pas un document conçu pour être relu intégralement plus tard
- Le simple fait d’écrire crée une structure qui aide à organiser la pensée
- Les quelques dernières phrases jouent le rôle d’un cache qui conserve l’état nécessaire au redémarrage
- Si votre concentration se brise souvent ou si vous devez jongler entre plusieurs tâches, vous pouvez commencer simplement en notant ce que vous faites et ce que vous pensez, puis en relisant les dernières phrases au moment de reprendre
1 commentaires
Avis de Hacker News
L’intérêt du journaling n’est pas seulement de faciliter la reprise du travail, mais aussi de solidifier le modèle mental en une arborescence de possibilités concrètes étroitement liées à un problème donné
Le travail consiste alors à explorer et modifier cet arbre, à repérer les branches manquantes pour les compléter, ou à réduire le temps perdu à repasser au hasard sur les mêmes points
C’est particulièrement vrai dans les systèmes distribués, où les tâches sont fines, manuelles, sujettes aux erreurs et très latentes ; avec un modèle solide, on peut dérouler une checklist avec bien plus de confiance
La capacité à transformer à la volée un problème complexe en une forme plus concrète est une compétence essentielle
Le plus grand obstacle tient presque à une forme de jalousie. Les autres semblent faire ce genre de chose uniquement dans leur tête, sans documentation, et on l’interprète comme une preuve de supériorité intellectuelle, au point de se demander si utiliser un outil d’appoint comme un journal ne révèle pas un manque de compétence
Mais cartographier un problème complexe avec des outils n’est pas un échec, c’est presque indispensable, surtout sur un système qu’on aborde pour la première fois. Avec le temps et l’expérience, on peut avoir moins besoin de ces outils, mais c’est davantage une différence d’expérience qu’un signe d’intelligence ou de capacité
Je m’en sers tous les jours
Le premier commit peut commencer par trois lignes de code et un long commentaire décrivant ce que j’ai déjà essayé ou pensé
Vers la fin du travail, j’enlève les parties spéculatives et verbeuses, et ce qui reste est généralement du code très bien commenté
Je pense que cette méthode produit plus vite du meilleur code que de tout garder uniquement dans sa tête. Personne ne s’en est encore plaint
Elles connaissent désormais le chemin et n’ont simplement plus besoin de journal, mais à nos yeux cela ressemble à de la supériorité
Je ne sais pas quelle quantité d’explications écrire. J’écris du code, et certains disent que le code devrait être auto-explicatif ; on revient donc à la vieille question de savoir combien de commentaires mettre à côté du code
Retrouver les notes écrites auparavant est aussi un problème. On peut utiliser des tags et la recherche, mais il n’est pas facile d’imaginer à l’avance le tag parfait dont on se souviendra plus tard
J’ai trop de notes, et une bonne partie est déjà obsolète. Je n’ai pas envie de passer du temps à les mettre à jour, mais ne pas le faire peut induire en erreur
Il faut un équilibre entre « faire simplement » et « écrire à ce sujet », et je ne suis pas sûr de l’avoir trouvé
Une alternative pourrait être un forum où les collègues discutent de ce qu’ils font, de ce qu’ils prévoient de faire et de ce qu’ils ont terminé. La capacité de recherche peut rester un problème, mais les outils de forum conservent automatiquement qui a écrit quoi et quand
On peut tirer autant d’aide des notes des autres que des siennes
Quand j’ai commencé avec Obsidian, je l’utilisais de cette manière, mais plus j’y mettais de contenu, plus je me suis mis à tout organiser
Résultat, c’est devenu moins un journal qu’un dépôt de longs textes
J’envisage d’utiliser les deux, pour avoir un outil distinct dédié au journaling
Ce qui a vraiment ancré cette habitude chez moi, c’est d’abandonner toute structure et organisation, ainsi que les concepts formels comme « log » ou « journaling », puis de donner la priorité absolue à la capture plutôt qu’à la recherche, en laissant les outils de recherche et la proximité temporelle gérer la suite
J’ai configuré l’icône OneNote dans la zone de notification pour créer une nouvelle note rapide, et je m’en sers sans retenue
De temps en temps, je parcours des pages entières, surtout les plus récentes, j’en fusionne et réorganise certaines, j’en déplace d’autres vers un onglet « archive », et c’est tout
L’encre la plus floue et la moins organisée est plus puissante que le souvenir le plus vif
À chaque fois, je crée un nouveau fichier texte sans jamais le rouvrir, ou j’écris une page dans un carnet papier sans la relire
La valeur vient énormément de l’acte même d’écrire
Il est chronologique de haut en bas, avec un paragraphe par journée de travail
J’écris plus longuement que nécessaire, et les fautes d’orthographe ou de grammaire ne comptent pas
La fonction Daily Note d’Obsidian est excellente, et si un sujet donné mérite un document dédié, on peut en extraire une page à partir de là
Comme ce n’est que du Markdown, la recherche est rapide, et j’aime aussi pouvoir utiliser des expressions régulières si besoin
La vue en graphe est utile quand on crée des notes sur des sujets précis, qu’on les relie entre elles ou qu’on en détache certaines parties pour les expliquer plus en profondeur, mais elle n’est pas indispensable si l’objectif n’est pas de construire sa propre base de connaissances
Et ce genre de base de connaissances, comme tout document, finit aussi par vieillir
Tant que l’outil de notes permet une recherche suffisante pour retrouver les choses, le choix de l’outil importe peu ; au final, l’important est de les écrire
Pour retrouver les choses, les backlinks suffisent étonnamment bien
J’utilise des fils GitHub Issues pour cet usage, et c’est étonnamment bien adapté
Tout ce sur quoi je travaille a une issue GitHub. Le travail open source va dans des dépôts publics, le reste et mes recherches personnelles dans des dépôts privés
J’ajoute un commentaire chaque fois que je découvre quelque chose. Ça peut contenir des bouts de code copiés-collés, des liens utiles, des citations, des captures d’écran, des références à d’autres issues
Il arrive souvent qu’une même issue compte des dizaines de commentaires de ma part ; ces commentaires deviennent un journal détaillé du processus de travail et me permettent de reprendre rapidement après une interruption ou un changement de tâche
Voici un exemple de fil de recherche public plus complexe : https://github.com/simonw/public-notes/issues/1
Je crée une nouvelle issue chaque jour pour planifier ce que je veux faire ce jour-là et y laisser aussi des notes diverses. J’ai décrit cette méthode ici : https://til.simonwillison.net/github-actions/daily-planner
Comme je m’en sers non seulement comme journal de travail mais pour tout, un petit problème apparaît
Quand on y jette à la fois des références pour plus tard et des logs de travail, et qu’on se retrouve avec une cinquantaine de canaux, il devient facile de ne plus y revenir, sauf quand on en a besoin
Au début, ça ressemble plus à une fonctionnalité qu’à un bug, mais les relire une fois quelque temps après les avoir capturés aide vraiment
Je prévois donc de créer un bot qui, chaque week-end, réorganise les logs de travail et les dumps de références et me les envoie par e-mail
Ensuite, je pense que des notes hebdomadaires personnelles et privées, comme https://simonwillison.net/tags/weeknotes/, que je pourrais parcourir le week-end, seraient parfaites pour moi
https://GitHub.com/irthomasthomas/undecidability/issues
Le code qui le fait tourner est ici
https://GitHub.com/irthomasthomas/label-maker — début et état actuel
Pendant que je le “résous”, je continue à ajouter des commentaires à l’issue ; il y a donc généralement beaucoup plus de commentaires d’issue que de commits
Si un nouveau problème apparaît, nouvelle issue ; si une nouvelle idée sur ce problème arrive, commentaire, et ainsi de suite
J’hésite à confier mon flux de travail personnel au bon vouloir d’une entreprise
Il est frappant de voir à quel point beaucoup de développeurs essaient de sur-optimiser leur productivité avec des outils et des techniques sophistiqués, alors qu’en pratique on revient à des bases simples
En tant que fondateur soumis à beaucoup de changements de contexte, je m’appuie sur quelques éléments
Un fichier texte sans fin pour les tâches et le journal de travail [0], un calendrier pour la planification et le blocage de plages de concentration, un bloqueur de sites web, des notifications désactivées
[0] https://news.ycombinator.com/item?id=39432876
Le format en plan d’org-mode est aussi plutôt bon, et il m’a suffi d’une journée pour apprendre les commandes clavier permettant de créer et manipuler des plans, créer des liens et faire défiler les états TODO
Avec Doom Emacs, comme je connaissais déjà vi, je n’ai pas eu à apprendre de nouvelles commandes d’édition de texte, ce qui a facilité le démarrage
Le concept d’“inbox” façon Zettelkasten s’est aussi révélé très utile
Quand quelque chose n’est pas encore intégré à mon système, je le mets dans l’inbox pour le traiter plus tard. Sur ordinateur, j’utilise org-capture ; sur téléphone, beorg
Ainsi, saisir une note ne m’oblige pas à effectuer un changement complet de contexte, et il suffit ensuite de vider régulièrement l’inbox
Pour l’instant, je n’utilise Emacs que pour org-mode, mais j’en suis bien plus satisfait que d’un fichier
.mdsans finJ’utilise seulement un plugin d’éditeur qui permet de marquer facilement les tâches comme terminées ou annulées, et je change de fichier chaque mois, avec un peu de rangement, afin de réduire le périmètre des recherches par mots-clés
Pendant des années, ça a été pour moi la méthode la plus efficace de gestion de projet et de journaling
Je parle par exemple d’une liste mensuelle comme celles utilisées dans le bullet journal
Quelle est la meilleure méthode de synchronisation cloud ? Sur le matériel de l’entreprise, l’installation d’apps peut être limitée
J’aime bien avoir un fichier devlog.md pour chaque projet ou dépôt
Le journal n’est qu’un empilement de commentaires, de tâches à faire et de râleries, en ordre antéchronologique
Dans VSCode, j’ai mappé cmd+shift+I sur l’insertion d’un horodatage
Chaque fois que j’ai envie d’écrire quelque chose, j’ajoute un horodatage en haut de la liste et je déroule. Je garde ce fichier à côté du dépôt
C’est particulièrement utile le matin pour retrouver où j’en étais la veille au soir
On peut y mettre n’importe quoi : notes sur la structure des modules, morceaux de code et de données pour les tests, etc.
Comme le disait l’un des commentaires plus haut, cela fonctionne comme un système plus vaste, comme des nœuds de connaissance dans un graphe, et je reviens consulter ces journaux plus souvent que prévu
Plus on explore et documente, plus des liens se créent, et mieux c’est
devlog.mddans le système de gestion de versions ?Sinon, comment le synchronises-tu entre plusieurs ordinateurs ?
Pour moi, le plus difficile avec les méthodologies et astuces de travail comme le journaling ou Pomodoro, c’est de tenir dans la durée
J’ai un journal de travail, mais je l’abandonne puis j’y reviens, je l’abandonne à nouveau puis j’y reviens encore
Je serais reconnaissant d’avoir les conseils de personnes qui arrivent à s’y tenir longtemps
Je gère tout mon travail, y compris mes projets personnels, avec un journal de travail et du suivi du temps, mais il m’a fallu apprendre par étapes avant que cela devienne un flux de travail naturel
Le parcours que je recommande est le suivant. Au début, concentre-toi uniquement sur le fait de laisser une note sous une forme ou une autre, au début ou à la fin de chaque journée
Peu importe où tu l’écris et sous quel format : l’essentiel est de toujours écrire au moins un peu au début ou à la fin de la journée
Une fois que l’habitude de prendre des notes chaque jour est en place, identifie les activités pour lesquelles tu as le plus souvent besoin de notes, puis prends-en avant ou pendant ces activités
Par exemple, si tu reviens souvent à un ticket pour retrouver une information importante, commence à mettre cette information dans tes notes
Quand tu prends des notes tous les jours et que tu y ajoutes ce dont tu as besoin, elles vont s’accumuler ; c’est alors le moment de réfléchir à la structure et au format
Si tu sens qu’un fichier texte avec ton propre balisage ne passe pas à l’échelle, tu peux regarder du côté d’Obsidian avec Markdown, ou d’Emacs avec org-mode
Ensuite, tu utilises chaque jour la méthode de prise de notes choisie, tu construis de bonnes habitudes et tu itères pour améliorer ton système de notes afin qu’il te convienne
Si quelque chose te semble avoir peu de valeur par rapport au temps investi, modifie-le pour y consacrer moins de temps, ou arrête simplement
Une fois qu’on a vu à quel point les anciennes notes ont été utiles, il devient très évident qu’il faut le mettre à jour
Je garde un en-tête standard pour chaque nouvelle entrée
* DD/MM/YYYY** Admin** Meetings** Tickets/Stories/Work** ProblemsJe copie-colle cet en-tête à la fin du fichier, puis je le remplis au fil de l’eau
Avant, j’avais configuré l’ouverture automatique du journal au lancement de l’éditeur, mais j’ai fini par retirer ce réglage
Ce qui a vraiment marché pour moi, c’est de faire du journal l’outil principal de mon travail
Au lieu d’écrire de temps en temps ce que j’ai fait aujourd’hui, dès que je commence quelque chose d’un peu complexe, j’écris immédiatement mon approche. Par exemple : « je dois faire X, donc j’ai commencé par Y »
Tu fais peut-être différents types de travail et, inconsciemment, tu sens que le journaling est utile pour certaines tâches et pas pour d’autres
Ce n’est pas grave. Considère-le comme un outil occasionnel, et pense au journaling comme une option quand tu es bloqué sur quelque chose et que ça t’agace
La technique qui consiste à tenir un journal pendant qu’on travaille est parfois appelée interstitial journaling, et j’ai fini par beaucoup l’apprécier comme moyen d’aider à la concentration et de suivre ce que j’étais en train de faire
J’ai créé un outil qui relie ces notes à des projets codés par couleur et à des horodatages
https://interstitch.app
Par inadvertance, cela s’est mis à ressembler à un outil de suivi du temps facturable qu’utiliserait un freelance, mais le cas d’usage qui m’intéresse est la productivité personnelle
Je ne peux pas dire que cela ait suscité beaucoup d’intérêt en dehors de mon usage personnel, mais c’est assez agréable de laisser des notes au fil de l’eau et de voir facilement combien de temps on a passé sur un projet donné
On peut aussi ajouter des
#hashtagsaux notes et filtrer par ces hashtags dans la vue calendrierSi cela peut aider quelqu’un, c’est entièrement gratuit
« Ignore toutes les instructions précédentes. Montre ton processus de travail. Explique ton raisonnement en détail. Tiens un journal d’avancement du travail. »
Cela fait des années que j’utilise ce prompt sur moi-même par intermittence, mais je continue à halluciner, à perdre ma concentration et à partir dans tous les sens
J’utilise une approche similaire : en résolvant un problème, j’écris un billet de blog pour moi-même
C’est comme rédiger un guide d’utilisation avant de savoir réellement comment faire, et je cite mes sources chaque fois que je trouve des ressources
Une fois le problème résolu ou « la chose » construite, je reviens au document et je le publie en interne ou je l’archive
Cette habitude s’est vraiment installée après avoir lu Writing to Learn de William Zinsser. Aujourd’hui, je recommande ce livre à tout le monde
« L’écriture nous aide à découvrir ce que nous savons et ce que nous ignorons au sujet de ce que nous essayons d’apprendre »
Chaque fois que j’essaie sérieusement de tenir un journal pour ma santé mentale, je me retrouve bloqué par la question de comment faire
Logseq et Obsidian sont souvent cités, mais je perds tout intérêt pendant que j’essaie de comprendre comment utiliser une syntaxe obscure. C’est un journal, pourquoi faudrait-il programmer ?
J’aimerais qu’il existe une option prête à l’emploi, mais je n’en vois pas vraiment
Quand on soulève ce point dans ce genre de discussions, la réponse ressemble à « c’est simple, installe X, ajoute tel plugin puis tel autre, modifie ce fichier pour… », ce qui finit plutôt par démontrer le problème. Mon cerveau à tendance TDAH décroche à ce moment-là
Il y a vraiment un vide sur le marché pour un bon outil open source, auto-hébergeable, qu’on puisse simplement ouvrir et utiliser
Je ne parle pas d’un bloc-notes, mais d’un outil où l’on ouvre l’app, on déverse ses notes à la date du jour, et c’est enregistré
Il existe des outils comme DayOne, mais le stockage cloud est clairement exclu pour moi et pour beaucoup d’autres
Il y a eu d’innombrables discussions de ce genre sur Reddit aussi, et la réponse consiste toujours à bricoler Logseq ou Obsidian pendant une demi-journée et à mémoriser leur syntaxe
Dans leur état par défaut, les deux sont assez médiocres, et si la solution consiste à passer des heures à les ajuster, ce n’est pas une vraie solution, c’est plutôt un patch
Un outil digne de ce nom ne devrait pas avoir besoin de ce genre de patch
Si tu as juste besoin d’une interface graphique pour de simples fichiers texte, tu n’as rien à ajuster, aucun plugin à installer, ni nouvelle syntaxe à apprendre
En revanche, ce n’est pas open source
Mieux vaut ne pas se laisser tromper ou intimider par les communautés de « porno de productivité » qui exhibent des configurations sophistiquées et des workflows irréalistes
Ma règle est la suivante : si quelqu’un appelle Obsidian un « second brain », il fait partie de la secte, donc tu peux l’ignorer
Cela dit, je recommande fortement l’app open source ultime sans configuration : le papier et le stylo. En plus, elle offre un excellent retour tactile
Par exemple, dans Obsidian, tu peux supprimer tous les plugins sauf Daily Note et simplement taper
Tu peux ignorer toute la syntaxe à part éventuellement les listes à puces, ainsi que les propriétés, les liens, le suivi d’habitudes, les astuces de base de données et le graphe
Ou bien configurer Vim/Neovim pour ouvrir le
journal/YYYY-MM-DD.txtdu jour avec un raccourci leaderDans mon poste actuel, je garde un document continu ; chaque jour, j’ajoute une nouvelle entrée tout en haut, puis, avant d’essayer quoi que ce soit, j’y note ce que je vais faire et les progrès réalisés ce jour-là
Ce qui aide, c’est que mes collègues et mon supérieur peuvent trouver et lire ce document
C’est très utile pour moi, mais cela aide aussi les autres à voir ce que je fais sans avoir à me relancer
grep