Thanks Sebastien! That was very confusing indeed.

It's great that you took the time to report a full JIRA, but for your convenience know that you can search the documentation sources and propose changes directly from GitHub:

• https://github.com/hibernate/hibernate-search/search?utf8=%E2%9C%93&q=also+have+to+mark+all+fields+of+the+associated