Migrate site to markdown?

[andrzejj0]

Just an idea. Should we migrate the site to markdown? Easier to maintain imho, plus it's compatible with github and many tools including builtin plugin in IntelliJ

https://illegalexception.schlichtherle.de/maven/2013/06/17/how-to-use-markdown-syntax-with-the-maven-site-plugin/

[sultan]

other projects like TomEE use asciidoc, but Markdown is a bit simpler to use and generate html. no dependencies on jbake or the kind. difficulty arised trying migrating all the pages... and not loose content.

maintaining the docs with any LML has been a breeze for me these past months.
MD has almost no entry cost for accustomed github users.

[slawekjaranowski]

We can do it - please one document per one PR.

By the way content should be verified if is still valid and corresponding to current implementations ... 😄

• .vm files is only needed if we have properties in document

• instead of # for headers - we can use

Header level 1
===========

Header level 2 
--------------