more clear parameter names
streamline match metrics:
default parameters
doc strings
example of read results generator in Python
minor
package examples
fix bugs, improve examples