Question: Move documentation from separate repository to README.md

[k00ni]

Reasons against separate repo:

• documentation became outdated, because updating documentation can be time consuming
• different branches, different versions .. how to keep documentation aligned with latest development efforts?
• website building using Jekyll sucks. I spend too much time formatting stuff without a result. Using plain markdown provides less options, but you at least can control the output.

[white-gecko]

• I don't get how moving the documentation into a huge README would solve this problem.

• Markdown + header is enough for jekyll

• + heaving a separate repository allows better organization of the documentation

• -> the webpage could be reorganized