pull up true/false checking for consistency
add documentation (inline comments)
remove old test case
update readme