Clean up README, fix typs and merge in DocBook tips.