As much as I hate writing documentation, I agree that it's a necessary evil. I also try to be as descriptive as possible where it makes sense. But, do we really need a 6-page document explaining how to run a query that updates a user's role?