Fix documentation warnings

When processing the documentation some warnings were issued for some time now. I took the time to fix those, along with some other minor improvements. This also lead to commenting out parts of the API that are untested. Test will be written (hopefully) soon. The text can be included again, with the respective snippets being present.