> there is great potential to have finally good documentation

Yes, true, no good documentation has ever been written in Markdown. Good point.