Within the Hibernate projects there is a move away from docbook towards asciidoctor. The key benefits are:

• easy of editing
• less merging problems due to re-formatting
• easier to automate and integrate into the hibernate.org web site