add documentation about readable index types