Adapt comments into RDoc convention

We already have an OK documentation present on the comments across the projects' files. This is fine, but RDoc pages are being generated with poorly formatted examples and some of the examples across the code are not being placed where it should.

This is very visible at our [Ability docs](https://www.rubydoc.info/gems/apicasso/0.4.11/Apicasso/Ability), which has fine examples, but they are very badly placed. Other examples are being poorly formatted, like the ones on the [CRUD Controller endpoints](https://www.rubydoc.info/gems/apicasso/0.4.11/Apicasso/CrudController).

This should be fixed for a better documentation.

Beginnen Sie damit, die in den verlinkten Ability docs und CRUD Controller endpoints dargestellten Kommentare zu überprüfen, und suchen Sie anschließend ihre Quellkommentare im Repository. Vergleichen Sie die generierten Beispiele mit den RDoc-Konventionen und verifizieren Sie, dass die Beispiele in der resultierenden Dokumentation korrekt formatiert und platziert sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.