Better document existence and use of `.metadata` file

[parlough]

The Developing packages & plugins page does mention it briefly in the explanation of created packages, but doesn't provide much info.

We should consider beta explaining this file somewhere. What it currently does, if/how users can use it, and potentially what it may help with.