Document compositional fields and other aspects better.

Done. If you're happy with it, please merge.