Convert doc/ documentation into something closer to plain text

[ohault]

Imported from readme.md for easier follow-up.

[sskras]

Unsure which plain-text markup format is preferable, but given the complex nature of the technical documentation I'd recommend choosing AsciiDoc instead of Markdown (let alone the reStructuredText).