Skip to content

Migrate to a new docu framework

Posted on:February 23, 2023 at 01:28 PM

How to?

Everyone struggles to document. For the last year I used Docsy by Google… It allows you do write markdown files, tag them and the structure is file based. It’s a theme for Hugo, which is written in Go. They have a nice structur to tag pages and offline search, but overall I didn’t want to restyle the code sections and I wanted to have a day/night theme.

So I found Docusaurus by Facebook.

Look how cute that dino is… Still markdown, it uses MDX. You can use your own components and overall, I think, I traded the tag sidebar to get a nice theme. Maybe I can find a new plugin to get tags enabled again. Sadly I lost the Git meta information, but this was never important. It was a nice feature to have.

Reference