even more docs explaining the format of the objects defined by the json input file