Add a documented example
Comment the example code

A bit of clarification
Fix tests
Allow for higher versions of pytest