Merge pull request #290 from graphitefriction/writers-guide

resolves #289 updates subs and passthru sections
resolves #291 updates lists and urls sections

- list types, hybrid, and complex
- urls, relative and xref