See the general Documentation guidelines http://docs.gitlab.com/ce/development/doc_styleguide.html
closes https://gitlab.com/gitlab-org/gitlab-ee/issues/2943