When you're writing code, don't forget that one of the people who might end up using it, one of the people you need to write docs for, is you. Specifically, a version of you 3-5 years from now who has no memory or idea of what you were thinking when you wrote it.