Document restrictions/assumptions/formatting for metadata file

[wpears]

Going field by field would be nice, with info such as "name MUST be lowercase, as this is transparently passed through to elasticsearch as part of the index name (which requires lowercase)".