Operations whose documentation must be updated in the Java code:
Problem is when you use one of these in aboutToCreate or beforeDocumentModification. As the java code saves the document by default, for compatibility reason (it was the original implementation before the parameters were added), using default default values :=> document is saved => this fails miserably for these events.
Notice AddFacet and RemoveFacet already explains the issue but don't mention the value is true by default, they just state that "Save parameter automatically saves the document in the database [...]".
Another way to handle that would be to detect we are in the context of these listeners and then don't save. First fix: let the developer handles this.
It is major and high backlog priority because it is very confusing and quite hard to debug/understand for prospects discovering Nuxeo.