I just found a tab with my review of #729 unsubmitted, so I'm opening this new issue with my comments:
See contentHint:
NOTE: Any codec-specific encoding options take precedence over contentHint.
This seems to be a requirement, but is in an informative note, and that's not correct. We want to describe in what case and which codec-specific option overrides this contentHint. Also, we might want this for audio, e.g. we could make it map to those Opus flags: https://github.com/xiph/opus/blob/master/include/opus_defines.h#L191-L199