Self-documenting code is (mostly) nonsense
Your code isn’t as clear as you think it is, but there’s things you can do to help

I just got through reading Cindy S Cheung’s great article on technical documentation and why devs need to explain their code better, and I have to say I completely agree.