one more round of refactoring

* collapse reactions & traits in to facets
* update documentation