Fix issue #648 and add QOL Readability Improvements

[SolarisEclipse]

This PR adds quality-of-life readability improvements and fixes #648.

[SolarisEclipse]

I spent some significant time on this to make it more readable and it was easier to follow for me, but if you reject it. I totally understand.

[unixfox]

Thanks, I'll take a look at it more closely when I'll have time.

Could you please test if that works great on the final version by launching mkdocs, the doc is here: https://github.com/iv-org/documentation#running-the-documentation-locally-for-development-purposes. Either use pip or docker. Thank you!

[SolarisEclipse]

Will do