Merge pull request #288 from graphitefriction/writers-guide

resolves #287 updates writers guide
resolves #289 updates subs and passthru sections