comparison instead of comparaison.
I have a general remark on the fact that we never explain to the user that everything is based on a specification (generated API schema). That is not explicit that the documentation must be written before beginning with bump. Yesterday I discussed with a developper that discovered completely the product, and he kept saying "but how do you spot that I changed the code of my API and it it needs more or less documentation?". He really didn't see the how the diff could be displayed.
I don't know if this insight should be taken into account for this iteration.
To sum up: