How-tos
Create custom statuses for pages in Material for MkDocs
The Material theme for the MkDocs static site generator has a Status feature. You can use frontmatter to mark a page as either new
or deprecated
, and the theme gives it an icon in the navigation.
Recently, at n8n, I wanted to mark pages as beta
to signal they're documentation for a beta feature. I didn't want to use new
and its default icon for this, so had to add a custom status.
Set up minikube on Windows
In my work as n8n's tech writer, I need to maintain some Kubernetes-based deployment guides. This blog post contains the steps for setting up minikube and kubectl on Windows, running it, and testing n8n's Kuberenetes hosting configurations. This is a letter to my future self. Some steps are n8n-specific, but this can also serve as a quick guide for any Kubernetes testing.
Cookie consent across subdomains with Material for MkDocs
This post looks at why you'd want shared cookie consent across your subdomains, then outlines the key features to be aware of when setting this up with Material for MkDocs, and provides a code sample to help you get started.
Add cover images to blog posts in Material for MkDocs
Modify Material for MkDocs to include cover images on the blog index page.
Prevent MkDocs from replacing tabs with spaces in code blocks
This article describes MkDocs' default processing of tabs in code samples, explains why it can be a problem, and shows how to fix it.
Using Markdoc with Eleventy: a quick test
Trying out Stripe's recently open sourced Markdown extension and linter.
Diagnose issues with your Windows PC hardware
A short list of free diagnostic tools.
Setting up a new Windows PC
Some notes to my future self, for the next time I set up a new Windows PC.
Notes on my Raspberry Pi Zero setup
Some notes to help me next time I need to reconnect to my Pi Zero from Windows 10.