Skip to main content

3 posts tagged with "Tools"

Blog articles on technical writing tools in docs-as-code: text, diagrams, style guides, architecture, clarity and quality.

View All Tags

Structured Data: From Manual Root.js to a JSON-LD Plugin

· 7 min read
Florence
Expert Technical Writer

How my work on structured data eventually turned into a Docusaurus plugin

In my previous article, "I Took Control of My Metadata", I explained how I explored two different ways of injecting structured data into Docusaurus.

That work led me to a simple conclusion: for a bilingual, content-rich website designed for modern SEO (including SEO, GEO, and generative engines), none of the existing approaches were sustainable in the long run.

At that point, I had a choice: accept growing complexity… or change my approach entirely. That's how a third method emerged — and eventually, a plugin.

My 2026 Toolset

· 4 min read
Florence
Expert Technical Writer

The 2026 Toolset for Docs‑as‑Code and AI‑Friendly Technical Writers

In the age of AI, docs‑as‑code isn't a technical choice. It's a strategic one.

AI is advancing at an incredible pace. After agents, skills, and BMAD approaches, one thing has become clear: AI performs best when it works with clear structures, versioned data, textual content, and contextual information. In other words: the natural terrain of code.

That's exactly why documentation must now be treated like code.

My Favorite Tools

· 4 min read
CoffeeCup
Senior Technical Writer

Markdown, Docusaurus & Diagrams — My Happy Trio for Docs

A while back, someone asked me what tool I use for technical documentation — and instead of picking just one, I realized my setup is more of a creative trio.
I write in Markdown, build with Docusaurus, and sketch with Excalidraw. In this post, I'll share why this combo works so well for me and how it keeps writing both simple and powerful.