review comments

- some API docs
- require names for top-level actors
- allow names for children
- flag error when no channels declared