4 posts tagged with "Productivity"

🎬 Previously, in Episode 1...​

In Part 1, I explained why the usual approaches for managing structured data in Docusaurus eventually reach their limits: duplication, fragile maintenance, and complex multilingual setups.

Even with best practices such as @graph, the core problem remained: structured data lived next to the content instead of being a natural extension of it.

In this Part 2, we move from diagnosis to solution.

I'll show how this reflection led me to design a Docusaurus plugin, built from the ground up to:

• rely on front matter as a single source of truth,
• automatically generate JSON-LD compliant with schema.org,
• handle multilingual content cleanly,
• and remain maintainable over time.

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.

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 Docs-as-Code Way: A Philosophy That Builds Better Docs

For years, documentation happened only after development was finished. The method involved gathering information — sometimes straight from developers, but mostly within our own bubble, working among technical writers. Then one day, I realized something: I was using Git, writing in Markdown, pushing commits, editing in VS Code. Wait a minute — I was doing docs-as-code.