DOC: Moving away from restructured text

[funilrys]

For a long time, I adopted the reStructured Text format for the documentation and READMEs.
I now believe it has been an error and we should fix that.

I also believe that a mkdocs formatted documentation is more appealing for everyone: End-Users, Contributors, and Developers. Therefore, I started a new branch named switch-to-mkdocs which we should use for the documentation - until it gets merged into the dev branch.

If you want to see, what it looks like - right now, feel free to execute the following:

git checkout switch-to-mkdocs
pip3 install --user -r requirements.docs.txt
mkdocs serve

You are free and welcome to comment on this issue with:

• everything that you think is missing
• everything that you think should be rewritten or deleted

from the READMEs or documentation.

Cheers!

[funilrys]

• DOC: Please describe all arguments so their functionality is clearly understood. #265 should be fixed.
• FEATURE: Preload/Continue like the CI workflow ... but without Git #329 should be fixed.

[spirillen]

Why not just use the gh wiki?? it is the same structure and you only need to transform month of my works once!

[funilrys]

It's also a syntax conversion a lot of things won't change.

I also want the documentation to be a bit more "modern" looking. Right now, we can't embed any example asciinema videos ... 😞

See by yourself how it looks now:

git checkout switch-to-mkdocs
# activate environemt
virtualenv -p python3 venv
. venv/bin/activate
pip install -e .[full]
# Serve documentation locally.
mkdocs serve
# Open Documentation with browser.
palemoon http://127.0.0.1:8000

[spirillen]

Not spend a lot on this one, but ran into this error

mkdocs serve
Error: MkDocs encountered an error parsing the configuration file: while constructing a Python object
cannot find module 'material.extensions.emoji' (No module named 'material.extensions')
in "$SOME_PATH/funilrys/pyfunceble/mkdocs.yml", line 48, column 20

[funilrys]

Nice catch. I really need to start testing everything inside a container ...

[funilrys]

Patch is on its way.