fix doc formatting
Change upon jsdoc-amddcl/pull/23 and more cleanup.
add messages to assertion to make error intelligeable
Add supported browsers list to README.