add second test for random string, add documentation throughout source code.