When is the @Edits() decorator required for OntologyEditFunctions?

I have a number of OntologyEditFunctions that each edit a number of objects. These currently don’t have the “@Edits” decorator but are used in actions which are working as expected.

When is it required to add the “@Edits” decorator to an OntologyEditsFunctions? When it isn’t required, what benefits are there to using the decorator?

The docs imply that @Edits() acts as a backup to the static analysis of your code. It ensures that all the object types referenced in your code are detected and made visible to Actions.

So, my understanding is that most of the time both of the following are true:

  1. You likely don’t need it
  2. You should include it anyway