Skip to main content

The Docs as Code Philosophy

· 3 min read
CoffeeCup
Senior Technical Writer

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.

I tested Docusaurus V2

· 3 min read
CoffeeCup
Senior Technical Writer

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.