New usage for README.md

[Hywan]

We need enhanced README.md for each library (with more information in it).
We also need to use README.md when the documentation is not written yet.

Tasks

• Enhance README.md,
• Use README.md instead of documentation when this latter is not written yet.

[Jir4]

Take a look at http://pandoc.org to convert markdown into html.

[Hywan]

I was not thinking about compiling them to HTML once. I prefer to do this on-the-fly, like we already do for XYL to HTML. We can probably use http://commonmark.thephpleague.com/ if it supports Github flavors.

[Hywan]

Else, we can check http://parsedown.org/.

[vonglasow]

Even, if it's obvious for a large part of us, I think a part regarding bug reporting can be useful. I have made a test in this first template version of README.

See also discussion about sections here hoaproject/Central#19

[vonglasow]

@hoaproject/hoackers can we start with this version of template to align all README with it, or do you see any improvement.

I think it's not needed to have some section everywhere. like awecode section

[Hywan]

I would ask a feedback from @CircleCode before starting it.