An API that isn't comprehensible isn't usable.
Don't document bad code - rewrite it.
We have to stop optimizing for programmers and start optimizing for users.
Software engineering is not about right and wrong but only better and worse
