Can you instead put the examples "Examples" section? E.g.
```
Examples
--------
...
```

That corresponds better to the Astropy/numpydoc standards, which include just such a section