review comments

- some API docs
- require names for top-level actors
- allow names for children
- flag error when no channels declared
Merge branch 'master' into wip-channels-∂π