[documentation]: Readthedocs Improvements

[ReinhardKeil]

Is there an existing issue for this?

• I have searched the existing issues

This is a list of little things with the Mkdocs version https://open-cmsis-pack.github.io/cmsis-toolbox/

✔️ Wrap Table Text

Current Behavior

In the new documentation, table text does not longer wrap.
See: https://open-cmsis-pack.github.io/cmsis-toolbox/#revision-history

Expected Behavior

Explore if this mkdocs/mkdocs#3035 can be used to make it appear better.

✔️ Edit on GitHub

The button Edit on GitHub is great to let users fix little things. However, it does not go to the correct directory. Can this be addressed.

✔️ Max Width

Having a width limit improves readability. However, I suggest to increase the setting slightly so that examples like here don't require a scroll bar.
https://open-cmsis-pack.github.io/cmsis-toolbox/YML-Input-Format/#pack-name-conventions

Potential solution: Add this to extra *.css. (see also mkdocs/mkdocs#3598)

.wy-nav-content {
    max-width: 900px;
}

❌ Copy Code Button

Enable the copy code button (https://squidfunk.github.io/mkdocs-material/reference/code-blocks/)

This will be not fixed, as cut and paste is working fine.

✔️ Bullet Point List Spacing

The integrated GitHub formatter offers different bullet point spacing. An empty line in a bullet point list increases spacing.
See the difference on this pages:
https://github.com/Open-CMSIS-Pack/cmsis-toolbox/blob/main/docs/index.md
https://github.com/Open-CMSIS-Pack/cmsis-toolbox/blob/main/docs/overview.md

Fix is to add this to extra *.css.

.rst-content .section ul li p:last-child {
    padding: 0px 0px 8px 0px;
}

A: Need to review Python-Markdown/markdown#1497

✔️ Bullet Point Indenting

Mkdocs does not consider the bullet point indents. See the difference on this page:
https://github.com/Open-CMSIS-Pack/cmsis-toolbox/blob/main/docs/overview.md
https://open-cmsis-pack.github.io/cmsis-toolbox/overview/

To fix this use 4 intends. Note that markdownlint should be configured for this. In VS Code add to settings.json

    "markdownlint.config": {
          "ul-indent": {
            "indent": 4
          }
    },