added some documentation for non-interface methods