ENH: misc
- adding directives where missing
- fixing categorial interaction plots example
- improving example.rst