[hibernate-dev] [Search] Search 5 and architecture review

Hi, IMO we should rethink how we describe the architecture of Search and especially its extension points. I think for Search 5 we will need to review/rewrite the documentation (maybe as part of moving to asciidoc) and clear out some of the ambiguities we have in the used terminology. For example, ‘backend’. Technically it is the implementation of BackendQueueProcessor, but I think we sometimes used the term in the wrong context as well, for example when we talk about the "Infinispan backend” which is really a DirectoryProvider. Speaking of the latter, my understanding is that we wanted to move away from DirectoryProvider (at least from a configuration/ documentation point of view) and consistently refer to IndexManager. These are just two examples of various major and minor inconsistencies in how we describe Search. I think we really should spend some time and work out the terminology we want to use and weed out the documentation. Maybe this is something everyone can just keep in mind for a while to think about. Should we create an issue for this where we can collect ideas on what needs to be changed? —Hardy