Documentation

Je vous ai précédemment présenté Scratch qui permet d’éditer ses notes en Markdown et de les versionner sur Git. Aujourd’hui, je vous propose de découvrir Marp. Qu’est-ce que c’est ? Marp est un outil open-source qui permet de créer des présentations à partir de fichiers Markdown. Pourquoi choisir Marp ? Son principal atout est de s’appuyer sur le langage Markdown ce qui le rend accessible à la grange majorité des développeurs. Pour ma part c’est mon langage de prédilection pour rédiger mes notes et documentations. Ce site est d’ailleurs entièrement rédigé en Markdown. ...

Qu’est-ce que c’est ? Scratch est un outil de prise de notes que j’ai découvert récemment via un article sur Korben. Il permet l’édition de notes en mode WYSIWYG tout en étant markdown based. Parmi les principales features on trouve : Support des charts Mermaid Integration git Support IA : Claude Code, Codex, etc. Qu’est ce que j’en pense ? Je l’utilise depuis quelques jours et c’est vraiment agréable à utiliser. Son interface est très similaire à l’application “Notes” d’Apple, ce qui le rend très intuitif. Les fonctionnalités sont assez basiques mais suffisent amplement pour mes besoins de prise de notes, j’ai pu essayer Notion et Obsidian mais je les trouvent trop complexes pour ce que je veux faire, je passe plus de temps à configurer l’outil et organiser mes notes. ...

Qu’est-ce que c’est ? Hugo est un générateur de site statique open-source écrit en Go. Il permet de créer des sites web rapides et performants sans avoir besoin d’une base de données ou d’un serveur dynamique. Hugo est particulièrement apprécié pour sa simplicité d’utilisation, sa flexibilité et sa rapidité de génération. Pourquoi choisir Hugo ? J’applique un principe fondamental dès qu’il s’agit de choisir un outil : KISS (Keep It Simple, Stupid). Hugo s’appuie sur du markdown pour la rédaction de contenu, c’est un format que j’apprécie déjà pour la documentation technique. Les commandes pour build, déployer ou ajouter du contenu pré-formaté sont d’une simplicité enfantine, ce qui me permet de me concentrer sur la création de contenu plutôt que sur la configuration de l’outil. ...