Sanne/hibernate-search — comment on commit 5d174250ad037079454015b932211241d79ef350
File: hibernate-search-documentation/src/main/docbook/en-US/modules/mapping.xml line 705
By emmanuelbernard:

We only hear about the feature in the third paragraph. I'd put a short paragraph at the beginning of this section to explain what it is and then go into those lengthy discussions.

BTW shorter is better. A sentence longer than two lines is hard to read.