Because that’s apparently a best-practice to separate tutorials from reference documentation, to avoid overwhelming readers with a massive reference when they’re only after a short introduction.

Todo:

1. Split the documentation
   1. Move the asciidoc for “ Getting started with the Hibernate ORM integration” and “Getting started with the Standalone POJO Mapper” to separate directories/files in the source (we need two separate guides).
   2. Adapt pom.xml to actually generate those documents
   3. Adapt the distribution module to copy those documents (if it doesn’t already work; it may be copying all generated documentation already)
   4. Keep a (very short) “Getting started” section in the reference documentation, which will basically be the first two paragraphs we currently have, adapted to just point to the two getting started guides.
   5. Make sure all the anchors we had in there will point to that “Getting started” section.
   6. Convert links from the reference to the getting started guides (and vice-versa) to cross-references using xref.
2. Check the result
   1. Check that the new documents (both HTML and PDF) are correctly included in the distribution ZIP.
   2. Check that links from the reference to the getting started guides (and vice-versa) work correctly:
      1. In the distrubiton ZIP (at least the HTML version; the PDF probably won’t work).
      2. After being deployed to docs.jboss.org (not sure how we can check that; we don’t want to erase existing documentation during our tests…)
3. Remind Yoann to adapt the website to point to those docs when we next release Hibernate Search