add note to readme about breaking JSON change; move deprecations to own section