metadata - better documentation for format
cosmetic fixes