Using markdown for code: Guide or switch recommendation to MkDocs

[cmutel]

Pros

We are asking people to learn markdown for all Github-related stuff, no real reason to learn ReST as well.

Cons

• Markdown is inconsistent and lacks roles.
• Getting docstrings from code is very nice (possible in MkDocs only through a plugin)

@tngTUDOR Any opinion on this?

Of course, this is only a recommendation, people can still choose what fits them best.

[tngTUDOR]

I think Markdown is enough.