Document linting and improve documentation linting

After getting more experience with linting in this project, I thought I'd document what I learned: https://gitlab.com/gitlab-org/gitaly/-/blob/1841736b19d8b09b1328fb8c746524d26d685631/doc/beginners_guide.md#lint-code-and-documentation

While here, made some other improvements.