Refactor naming and docs

[bardram]

• [ ] consistent use of naming - what is a "controller" versus a "manager"?
• [x] Upper-case executor state names for consistency w. Core
• [ ] check that API docs looks good
  • [x] core
  • [ ] cams
• [x] organize in better sub-packages
  • [x] core
  • [x] cams