Add 1.x migration info to README and update jsdoc