Everything I know about good API design
Interesting article to consider when thinking about what is and isn't a good API design.
I tend to think that folk who spout the "my code speaks for itself, I don't need to document it or comment it" nonsense are at best mistaken, and at worst toxic individuals who want to gatekeep the industry.
This is an interesting blog post that contains some thinking I can mostly vibe with.