Après presque 15 ans en tant que rédacteur technique pour des sociétés de logiciels, je suis un converti à la philosophie de la documentation en tant que code.
En savoir plus
Lorsque j’ai commencé à écrire, j’utilisais l’anglais d’Oxford. C’est celui qui contient les orthographes -ize (correctes).
En savoir plus
Je suis un grand fan de Markdown. Il est parfait pour les wikis et la rédaction de contenu pour les sites statiques (la plupart du contenu de ce site est rédigé à l’aide de ce langage).
En savoir plus
Si votre documentation a atteint les limites de ce qui est possible en Markdown, et que vous préférez ne pas revenir au HTML, il est temps d’envisager la rédaction en XML.
En savoir plus
Cherchez sur Google des images de agilité, et vous obtiendrez des concours de chiens.
En savoir plus
Les API (interfaces de programmation d’applications) REST (representational state transfer) existent depuis le début du siècle, lorsqu’elles ont été définies par Roy Fielding dans sa thèse de doctorat.
En savoir plus
La Darwin Information Typing Architecture (DITA) et DocBook sont deux cadres de rédaction basés sur XML.
En savoir plus
Lorsque je suis passé du journalisme à la rédaction technique, les deux choses qui m’ont le plus manqué sont les guides de style et les rédacteurs.
En savoir plus
Cette semaine, je publie ce que j’espère être l’avant-dernière bêta de SE Basic IV (un interpréteur BASIC classique open source).
En savoir plus