942 documentation guidelines resubmit

See original pull request here: <https://github.com/okfn/ckan/pull/942>