api was documented (last section)
few tests were added