fix review display
improved documentation on DocBook related things