Polished README (style and markup)
Add categories
Change structure to more man-like
Make docbook build script work locally

To make it useful for ad-hoc building when working with docs.
Fix typos and add minor style improvements
Merge pull request #3 from AloisMahdal/doc-polish

Documentation polish