Add more details about the use of metrics metadata to the documentation

[jsoriano]

Generic guidelines mention the specification of metric types, units and dimensions, but it would be useful for package developers to have more detailed information about the implications of these fields, regarding having them vs. not having them vs. wrongly having them.

[ruflin]

@jsoriano Any updates on this. I started to play around with this in #4749 mostly around dimensions. I think we need an overall recommendation guide on what to use when.

[endorama]

Have there been any updates here? Aligning packages would help with consistency and would allow for other workflows to be built on top of these information.

[jsoriano]

@ruflin @endorama I have started a PR so we have some progress on this, let's iterate there: #5270 Suggestions welcome.

[ruflin]

@agithomas @lalit-satapathy For awareness as you are also working on this.

[jsoriano]

#5270 with some additional general guidelines merged, @agithomas is working on a more detailed guide in #5355.

[lalit-satapathy]

@agithomas,

What is pending on this issue. For example, we can see metric types in docs now:

[botelastic]

Hi! We just realized that we haven't looked into this issue in a while. We're sorry! We're labeling this issue as Stale to make it hit our filters and make sure we get back to it as soon as possible. In the meantime, it'd be extremely helpful if you could take a look at it as well and confirm its relevance. A simple comment with a nice emoji will be enough :+1. Thank you for your contribution!