correcting the json handling
updating the docs to match the present development