Document in confluence this new index optimization for handling dup keys more efficiently

Need some doco on this in the developer's guide. We also need a section on how to override the default dup limit for indices in the configuration on the user's guide.