add troubleshooting instructions for #880 and some small fixes

Merged Maarten de Waard requested to merge 880-document-yamltojson-error into master

Closes #880 (closed)

Merge request reports