Document the output of `header-translator`

[madsmtm]

header-translator's output, and by extension icrate, is basically undocumented, and especially after #574, it would make sense to have a central place to document how it works.