Nice article!
It's a tin line between good documentation and over-bloating users with too much information. It all comes down to writing the code, while keeping in mind you might not even understand it yourself in 6 months time.
At least that's mostly my approach: