Site Guidelines

Sep 1, 2025

Over the years I've rebuilt my website — a lot. Through successes and failures of past sites I've given myself the following guidelines for developing this blog.

1. Simple
Don't introduce unnecessary features or dependencies. Keep posts in vanilla Markdown. Remember: the more that is added, the harder it will be to maintain over time.

2. DX
Optimize for a good developer and writing experience. I won't be compelled to add content if it becomes tedious.

3. UX
The site must be fast, accessible, and mobile-friendly; there is no reason why all Google Lighthouse scores shouldn't be 100, or close.

4. Short and Sweet
Try to set a word limit of ~200 words per post. I have a natural tendency to write long posts, which often makes it hard to finish them before getting distracted.

5. Fun
Give myself permission to have fun with this site: run experiments, restyle, or even rebuild. However, this must never come at the cost of other guidelines.

↗ source