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