use key words from json doc
format comments & specs