prep for version 1.0.0, added some default values to definitions, updated some docs and tests, etc.