document hierarchical events
1.1.2