documentation: methods -- all done for now.