Improved some comments in the json client