Improve generated docs formatting
This gets as close as possible to what we already have.
Tables were suggested but as there the suggestions/descriptions are sometimes non-existent or the description is really large, I decided not to.
Screenshot of how it renders out:
Edited by Haelwenn