"indexBy" method now does not throw an exception when index duplication
will occur, README refactoring