Michael Heap

michaelheap.com

I write about systems, people, and what we learn when things go wrong.

Popular posts: 2
Total points: 641
HN comments: 338
Rank: #3,827 personal

Visit michaelheap.com → RSS feedOn Hacker News Sep 2026 – Sep 2026

Tools & Productivity 1 Software Engineering 1 Life, Learning & Writing 1 Career & Management 1

Most points Most discussed Most cited Newest

I don't want the details

2026466 points226 comments Life, Learning & Writing details

Why reasonable explanations are one of the easiest ways to avoid changing anything.

The GitHub wiki is an anti-pattern (2022)

2026175 points112 comments Tools & Productivity details

Using the wiki on GitHub makes life more difficult for your users, and you as a maintainer. Use the `/docs` folder and GitHub Pages instead and keep your docs in sync with code