update associations documentation

I tried to weight understandability against duplication of the ORM doc here.