Enhance html generation in Netlify for the lazydocs markdown files

[SamVanhoutte]

Describe the bug
Currently, netlify takes the markdown files of the API documentation and adds them in the table of content. But there are several layout issues in the rendering of things. It would be good to have this enhanced.

[SamVanhoutte]

I believe it would be good to discuss this with @Mcalewaert , as how to integrate the generated documentation in the final documentation website.
LazyDocs seemed to be the best & most lightweight solution , where some others seemed more complex (and might be better suited, if someone can take the time):

• Sphinx: most feature rich - quite complex
• Pydoc: was used in the initial builds, but that generates HTML. Don't know if that would be easy to integrate in the doc-workflow?

Interesting stackoverflow question on this: https://stackoverflow.com/questions/36237477/python-docstrings-to-github-readme-md