Document architecture of metadata mappings.

There's a lot of translate_* and normalize_* magic to avoid bloat. Once we're sure this structure is stabilized, we should document it (as well as expected return values, etc.).

---

Migrated from T1403 (view on Phabricator)