fix up docs and add another test
more tests for valid and invalid strings.