Document methods with TomDoc: http://tomdoc.org/

You don't have to go overboard, but you should have for every method, sections describing the following:
* One or two sentence summary.
* List of arguments with the constraints of each argument (type, bounds, etc)
* What will be returned for all possible cases