Profile picture of Damien Cavaillès
Damien Cavaillès
Décrypter le travail (tech & emploi) 🖤 #SaletéSincère
Follow me
Generated by linktime
September 3, 2025
👉 Une bonne doc vaut mieux que de bons tests. Les tests prouvent que ton code marche. La doc explique pourquoi tu l’as écrit ainsi. J’ai longtemps cru que documenter = gros chantier lourd (Confluence, Docusaurus…). J'ai écrit un guide sur la documentation technique pour WeLoveDevs.com et ça m'a fait prendre plein de bonnes habitudes : 1️⃣ DocDD → doc dans le flow dev, revue en PR, validée en CI 2️⃣ ADR courts → Contexte → Décision → Conséquences 3️⃣ Definition of Done → dans le README, CI qui casse si la doc n’est pas à jour 4️⃣ Vale.sh → cohérence de style sans effort Résultat 🎯 🧠 Moins de charge mentale. ⏱️ Des sessions de dev efficaces en 30 minutes. 🚀 Un agent qui repart toujours frais. Ce guide contient de vrais bouts de Julia March-Navarro, 🚀 Jean-Philippe Encausse et Pierre Wizla 👉 Tu veux mon template ? Commente CLAUDE.md et je t’envoie le lien en DM. Le guide complet est en 1er commentaire.
Stay updated
Subscribe to receive my future LinkedIn posts in your mailbox.

By clicking "Subscribe", you agree to receive emails from linktime.co.
You can unsubscribe at any time.

26 Likes
September 3, 2025
Discussion about this post
Profile picture of Arturo Guizar, PhD
Arturo Guizar, PhD
Data Science, Engineering & Strategy | AI Consultant & Trainer
15 days ago
claude.md
Profile picture of Pierre Wizla
Pierre Wizla
Lead Technical Writer at Strapi 📝Scientist at heart, web enthusiast, lifelong learner 👨💻 He/him
15 days ago
Merci pour la mention, Damien, toujours un plaisir de discuter de sujets avec toi ! Et le guide est une petite pépite ! Il m'a fait découvrir Vale.sh (qui correspond exactement à ce que j'essayais de faire in-house avec l'aide de Claude), donc ça tombe à pic ! (ou à Chocapic, not-so-private joke 😆)
Profile picture of Julia M.
Julia M.
Docs-as-code • Cloud • Education 📍Nantes 🐘/ Kyoto 🌸
16 days ago
Merci pour la mention, ce fût un plaisir d’échanger avec toi sur le sujet
Je ne reçois plus en entretien les Parisiens. Faut que je vous explique. Ça fait un mois que je recrute pour Allistic. En CDI. À Lille. En cybersécurité. Et je reçois 80% de candidatures parisiennes. Sauf que 80% de ma short list est Lilloise, bassin minier inclus de Téteghem à Maubeuge. Pourquoi ? L'écart de salaire est trop grand. Les juniors parisiens cherchent 45K alors que le marché ici, c'est 35K. Et c'est le haut du panier dans l'IT. Alors au pire, ils acceptent de faire des concessions. Mais leur vie parisienne va leur manquer et dès le premier weekend, ils vont prendre le TGV. Pour leur second poste, ils pourront aller chercher 50 à Paris et ils n'hésiteront pas. Ponpon sur la garonne : les titis parisiens qui ont jamais passé le permis. Qu'on s'entende bien, j'ai pas de voiture mais je sais conduire. Nos consultants interviennent dans des collectivités et PME des Hauts de France, il faut rouler. Bon, j'ai quand même des candidats qui prennent le TGV Nord pour venir en entretien. Mais ce sont des chtis 100% charbon qui ont été obligés d'aller à Paris. Et je les détecte en 5 minutes au téléphone. 🏇 Tu préfère les glaces de Malo-les-Bains ou du Touquet ? 🥘 Quel est le meilleur Welsh du Nord Pas de Calais ? 🚿 Et la piscine de Roubaix, tu prends ta serviette ? ⚽️ Ton meilleur souvenir à Bollaert (ou au LOSC ok les Dogues) Bref, j'ai deux postes qui n'acceptent plus de candidatures mais je vais bientôt en ouvrir un 3e. Indice en latin : IAM AD ENTRA Si tu bosses dans la Cyber et que t'as tous les points au QCM Maroille envoie un emoji 🙋
97 comments
June 26, 2025