Maybe as tip? And why? 

Generally I think the docs are clearly coming from someone who works with this all the time. Someone with less experience there would be a little more guidance needed. Again, something which probably needs to be addressed in a full review. Technically I am getting more and more confused about all this different configuration places - workers, directory providers, index managers. Maybe it would be time to rethink that and drop some of this complexity. Maybe the switch to Lucene 4 would be a good time to do that?