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

[Hardy Ferentschik]

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