Document compositional fields and other aspects better.

I thought we (Ryan, Julianne, me) went through this during the hackathon. I guess it depends on whether g points up or down. Care to explain why you think it is wrong?