My Intro to Vale CLI
As I dove deeper into docs as code, I discovered something pretty cool: there are tools that can automate tasks like spell checking and style guide adherence, and you can run them right from your command line!
Hi there! 🔗
Here, you'll find posts about all the cool things I've been learning on my never-ending journey to becoming a great Technical Writer.
2024 Year in Review
In 2024, I focused on leveling up my technical writing skills, and here are four key achievements that defined my year:
First Post of 2025
I'm going to try to keep this one short and sweet. Mostly because there are many things I want to say and I don't want to turn this into a lengthy scroll 😬.
I've been meaning to get to writing this post for a while now, but life's unpredictability and the 2024 holiday season definitely delayed the process. I've also made a resolution to work on my fitness and have been doing my best to stick to a discipline of exercising six days a week. I'm proud to say that it's been 6.5 weeks since I started and I'm still going strong! Scheduling my workout right before work energizes me. I'm also finding that I sleep better at night. Some of the exercises I've been doing have breathing routines, and I think those are great for clearing my brain before tackling my day so I can do my best work.
Anyway, happy 2025! Happy to be here, learning and thriving. 2024 was an incredible year in my growth as a human being and a Technical Writer. I'll be whipping up a post to summarize 2024 but just wanted to express my gratitude in making it to the other side. 2025, here we go!
Oh and yeah, one of my other resolutions is to write more blog posts to capture my learning journey and beef up my writing portfolio 😎.
My First Mermaid Diagram
It’s hard to believe it’s been almost three months since my July 5th post where I first talked about the magic of Mermaid. I’ve finally taken a stab at creating my own diagram. I based it on the swimlane diagram I originally developed for my Business Operation Process sample. However, I learned that Mermaid doesn’t support swimlane diagrams. In fact, you can refer to open GitHub issue #2028 to see the ever-growing list and demand to add swimlane functionality.
Since swimlanes are crucial for showing the transfer of information between five departments in my case, I opted for a sequence diagram. I figured this would at least show the interaction between different parties.
Want to check it out? Click here to see it in action in my SOP!
A Learning Moment
When I originally added a Google tag to my mkdocs.yml file, I thought everything was fine and dandy. After reading the docs, I added the string G-XXXXXXXXXX, and away I went. But later, I realized I should be protecting the tag by using an environment variable. So, I removed it and forgot about it for a while.