updated documentation and slightly improved communication between sub-controllers