Update the controller guide

Be clearer about the roles of the different
objects and which objects know about which other
objects.