Hi, I managed to migrate the whole User Guide to AsciiDoctor and you can check it out on this branch: https://github.com/vladmihalcea/hibernate-orm/tree/feature/asciidocs Next week, I'll start reading and reviewing it, and make a plan of what needs to be written so we have a full 5.0 user reference documentation. Have a great week-end, Vlad _______________________________________________ hibernate-dev mailing list hibernate-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev