examples, jsdoc improvement and updated README
making inline sourcemap tests less brittle