Update docs

@jpihl @petya2164 @jepkri @jledet 

Open for code review :)
criteria is plural, so I would remove the 'a':  we have custom equality criteria.