-- Leo's gemini proxy

-- Connecting to unbon.cafe:1965...

-- Connected

-- Sending request

-- Meta line: 20 text/gemini;

Journal graphique


2023-10-23


Après avoir occupé plusieurs postes intellectuels – En opposition à des postes physiques où les instructions ont le mérite d’être claires – en entreprises, j’ai constamment eu un même soucis : le manque de documentation.


Certes j’ai une fiche de poste – Ce qui ne présume pas de sa véracité ou fraîcheur –, et au moins une personne m’encadre au quotidien, mais cela ne m’oriente ni sur la manière dont les échanges sont réalisés au sein de l’entreprise, ni les petites opérations au quotidien.


Depuis mon entrée à mon dernier poste en date, je consigne scrupuleusement toute mes activités quoitidiennes dans un fichier – texte, évidemment[1] – où j’utilise un format 100 % artisanal et bricolé à l’arrache.


Comme quoi, l’expérience fini par s’accumuler, je pense pouvoir valoriser ce fichier et le transformer sous forme graphique. Parce ce que, bien qu’utilisable sous format textuel, il pourrait s’avérer intéressant d’avoir une vue d’ensemble si les projets venaient à s’accumuler.


Format


Le fichier prend la forme d’une liste textuelle où les entrées sont ordonnées de manière chronologique :


La date n’est pas entrée pour chaque entrée, trop chronophage, mais seulement comme séparateur entre groupes d’entrées, sous format ISO 8601 sur sa propre ligne ;

Chaque entrée est définie par au moins une ligne, composée d’une entête de trois caractères, suivis d’un espace, et de l’entrée à proprement parler ;

Dans le cas régulier de tâches plus complexes, la première ligne permet de donner un contexte — Généralement un nom de projet —, et une description est apportée par la suite sur des lignes débutant par une tabulation.


La flexibilité du format repose sur l’en-tête d’entrée, celle-ci permettant de définir l’état d’une tâche. L’en-tête se compose toujours de trois symboles qui représentent, de gauche à droite, le passé, le présent, et le futur. J’utilise différents caractères pour ensuite définir des états :


`o` pour l’attente d’un évènement qui ne dépend pas de moi (ex : Avis de collègues, devis d’une société ) ;

`+` pour la création de la tâche dans mon journal, apparaît généralement en position 2, puis 1, avant de disparaître ;

`-` pour une tâche en cours sur laquelle je m’active ;

` ` une tâche en cours sur laquelle je ne travaille pas encore. Ou, s’il précède un `+`, une tâche qui n’existait pas jusqu’alors ;

`|` pour une tâche terminée, qu’elle soit abandonnée ou conclue. L’important étant qu’elle n’a plus de raison d’occuper mon esprit.


Ce modèle fait directement miroir avec le système que j’utilise dans mon carnet papier[2] depuis quelques années déjà, et suffit à mon usage.


Des (méta)commentaires peuvent également être apportés sur des lignes débutant par le caractère arbitraire du point-virgule `;`.


Graphiques


À partir de ce format, on peut tirer une multitude d’informations, et tout autant de mises en forme. À l’aide d’un format similaire, il est possible par exemple de réaliser un diagramme de Gantt[3]. Trois choses sont à noter :


Le caractère `@` est utilisé pour identifier des personnes. C’est une idée pas inintéressante dans mon cas, et pourrait être directement intégrée sur sa propre ligne en commentaire d’une entrée ;

C’est un code en Python, ce que je me refuse encore à toucher (sauf exception[4]) ;

C’est basé sur le format PlantUML de la famille des UML[5].


En plus que le code soit en Python, la traduction se fait via le standard UML qui ne me plaît guère de part son aspect fourre-tout. Néanmoins, cela reste un standard comparé à d’autres formats comme DOT de Graphviz spécialisé dans la création de graphe, MermaidJS qui m’apparaît comme étant du DOT, ou TaskJuggler assez lourd à l’écriture.


@startgantt
<style>
…
</style>
Project starts 2023-01-01

-- Nouvel An --
[2023] starts 2023-01-01
[Resolutions] starts at [2023]'s start and ends 2023-01-02
[Depression] starts at [Resolutions]'s end

-- Nichoir --
[Documentation] starts at 2023-10-20
[CollecteLitterature] happens at 2023-10-20
[RedactionGemlog] happens at 2023-10-21
[Documentation] ends at 2023-10-22
[Materiel] starts at [Documentation]'s end
[Commande] happens at 2023-10-22
[AttenteLivraison] starts at [Commande] start

@endgantt

Reste plus qu'à j'ai envie de dire…


Références


[1] L’élégance du texte brut, LeJun 2022

[2] Journal : Puces, LeJun 2023

[3] Schedaus, rsp9u 2020

[4] Web Out Of Browser, LeJun 2023

[5] Unified Modeling Language, LeJun 2023

[6] Gantt diagram, PlantUML 2022

-- Response ended

-- Page fetched on Sun May 19 00:51:55 2024