What I want to suggest is to have one (About) Analysis subsection with the
text of About Filters and About Tokenizers merged. The division will look
nicer with having more descriptive texts in following subsections. The
order could be:
*Analyzers > Tokenizers (Description) > Filters (Description) > ...*
If we are willing to keep tokenizer and filter definitions separately, we
can merge the About and Description sections of Filters/Description
I'm reading the reference guide for the third time and everytime, this flow
seemed odd to me and thus, shared with you all.
*Paras Lehana* 
Development Engineer, Auto-Suggest,
IndiaMART Intermesh Ltd.
8th Floor, Tower A, Advant-Navis Business Park, Sector 142,
Noida, UP, IN - 201303