minor tests + improved doc
finished writing basic random tests - would need more thorough testing
against already existing solutions.