Documentation is done to give others with information and ease maintenance. The best documentation is done in the headers (function and scripts) and directly in the code. Any useful thoughts i.e. a chosen algorithm or a solution to a exact problem should be documented in order to help others understand the script(s) and/or function(s).