Convert docbook docs to markdown

[gilleain]

• Might be a bit of a regression in the quality of the docs.
• Need header and footers