Blog articles on using Static Site Generators (SSG - Docusaurus, Hugo, MkDocs) to create docs, from user guides to developer docs.
View All Tags
Hands-On Time
After collecting everything I could about artificial intelligence (Episode 1) and exploring how it could apply to my field, I decided to move from theory to practice by completely rebuilding my website.
Goal: Put my new knowledge into action and test, in real-world conditions, what AI can truly bring to a content professional.
The Help Files Evolution: From Pop-Ups and Frames to Markdown Bliss
I've been building online help since the early days — back when HTML ruled and editors were mainly plain text. Things have changed a lot, but some fundamentals are still going strong.
In this piece, I look back at how Help has evolved, from RoboHelp and tri-pane structures to the cleaner world of Markdown and static site generators. It's part nostalgia, part practicality — and all about making documentation better.
Migrating with Confidence: From Hugo to Docusaurus V2
This summer, I dove back into a client's documentation with a dual mission: explain their new API and migrate the entire site to Docusaurus V2.
From search engines to stylish admonitions and ReDoc integration, this version doesn't just look good — it works brilliantly. Here's what we gained, and what to watch out for.