document mandatory meta data elements more clearly