ISS Error-checking; Documentation Tweaks

* Correct README statements about shared folders
* Tidy README & documentation with Pandoc
* More robust defines, comments and error messages in ISS