completes method docs, cleans up tests