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