Sure, I can add some comments. Unfortunately, we are in an area of Lucene where the documentation is very bad. Javadocs are non existent and once has to rely on blog posts or tests in Lucene (which can be cryptic as well). I'll try to clarify anyways...