Update documentation to follow up recently changes. Link to json schemas instead duplicate the information.