added documentation on methods from tests

At last!