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
Merge pull request #52 from ThePacielloGroup/iss-error-checking-and-docs-tweaks

ISS Error-checking; Documentation Tweaks