Clean Up of Existing Documentation

[axkoenig]

Description

While preparing my PR on adding new documentation for the Huggingface, Hub and Torchvision drivers, I came across a couple of problems in the existing documentation which this PR fixes.

Main problems

• some python code in the docs was not rendered because of missing new lines
• some tables were not rendered because of wrong formatting
• there was a bad copy/paste error in the adult dataset docs (was copied from allanAI and showed up as a duplicate)
• Redundant naming of "dataset cards" was visually confusing
• the index.rst did not correctly apply "captions" to the datasets, hence no headings on the left sidebar
• all tables that show attributes and values of the dataset had no heading
• datasets were not sorted alphabetically, which was confusing

Fixes # issue

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring including code style reformatting
• Other (please describe):

Checklist:

• I have read the contributing guideline doc (external contributors only)
• Lint and unit tests pass locally with my changes
• I have kept the PR small so that it can be easily reviewed
• I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works
• All dependency changes have been reflected in the pip requirement files

Some Screenshots of Current Version

[winfried-ripken]

Great, thanks Alex! 👍

[winfried-ripken]

nice one!