Adding context to the documentation for metadata

Giving a longer description Thanks to justin mayer for #995