Minor documentation changes.
Added message so errors caused by json spec file format problems are not ambiguous.