Improvements for prometheus metrics documentation
What does this MR do?
Incorporates the CE/EE improvements made in EE only https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5011.
Incorporates the CE/EE improvements made in EE only https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5011.