Provide a way to add example to the documentation.

[nicolasdespres]

Responses are best described using a example to have an overview of how it looks like. Request too but it is less necessary. We could fetch the examples from the test suite using a filter.