Improve overall format and style of the mdbook

[mattaereal]

What content are you looking to modify or update?

Everything actually. Research on this should be an outcome of this issue.
Maybe we can start by defining a style guide?

Why do you think this update or modification is needed?

Definitively the current formatting and style could use some improvements.

Can you justify your argument and provide additional resources

Also related:

• Diataxis doc framework
• Google's markdown style guide

[Robert-MacWha]

Just incorporating a linter might be sufficient. I use prettier, but anything could work.

Something like https://github.com/marketplace/actions/lint-action, running automatically on PR, could help. Standardizes the document & code style by force and still lets people edit it with regular markdown editors. Auto-linting might take it a step too far (would that break anything?), but even just having it enforce similar to the spell check could work.

[mattaereal]

I do also think it could be a great idea!, but it seems that I have failed to bring a more deep subject to the matter, which is something like the diataxis doc framework, to shape the entire frameworks content upon it.