Skip to content

Hi there!🔗

Initial Thoughts on MkDocs

Today, as I drank my morning coffee and contemplated how to spend my lazy Sunday, I had an interesting thought. I already built a static site with Docusaurus (check it out here, by the way), so why not do the same with MkDocs? I frequently see technical writers praise MkDocs, just like Docusaurus, for its powerful documentation tools. I wanted to check it out myself, and when I coupled it with the Material framework...whoa!

So yeah, that's what I ended up doing today. There are certainly things I like and dislike about both. I guess the same could be said about food (personally, I'm not a fan of my greens). I'll sum up those thoughts in another blog, another day.

Mermaid?

Today, I learned about a new technology called Mermaid. It turns words into diagrams? How? My mind is blown! As a Technical Writer, creating diagrams can be pretty time-consuming. At first, I thought it could only handle flowcharts, but it can also create Gantt charts and user journey maps!

I can't wait to see how I can use Mermaid to speed up that process 🤯.

Second Post

Another day of learning! My original idea was to use this Docusaurus experience to only host my knowledge base portfolio pieces. However, I am taking the plunge and moving over my entire portfolio. Yup, everything! I even got to perform my very first Netlify deployment to production.

First Post

Whoa! Docusaurus is a pretty neat tool. I can't wait to learn how to master it and do cool things! I am happy. Here's to another tool under my Tech Writing toolbelt.