DOC: remove confusing parts of the documentation related to writing docs
Merge pull request #4276 from argriffing/remove-obsolete-doc-hacking-docs

DOC: remove confusing parts of the documentation related to writing docs