The handler can also be a condition object (same format as the object that can be returned from a handler function)

To confirm with @Convly, I think this is a unique name. We may specigy this: the name behaves as an unique id

shown ?

The custom conditions are not really in addition of the 3 defaults roles, they are in addition of the roles in general I think. Is there another way of saying this?

Adding, registering or declaring. These 3 words are used in this documentation. I think having just one would be enought and would add clarity on this point.

`if your condition is based on a plugin` or `if your condition is declared into a plugin`? I think it's 2 completely different meanings.

Some notes for this section. 1. we used to add (string), (boolean), (function) when we do a list of properties like this. 2. same for (optional) for the `plugin` for exemple.

```diff - `displayName`: the user name displayed in a friendly format, as showed in the admin panel + `displayName`: the name displayed in a friendly format, as showed in the admin panel ```

We should expand on this stating that you construct the conditions but they can be applied dynamically at any time in any environment since the assignment of them is stored in the database, not the file system.

Should we expand these example or is linking to sift enough?

I'm wondering if we should put the Bronze, Silver, and Gold badges here as while it is assumed that if you have a higher tier license it would also work (unlikely we would ever release a feature that is only for bronze and not silver or gold). It may not be clear to the user. :thinking:

Avoid using "we": you should either replace with "the Strapi team" or rewrite the sentence differently.

I would put that warning right after the title of that documentation.

- Avoid using "easily" in a documentation! Not all users may find it easy 🙂 - Could be nice to add capital letters to the names of the default roles: Author, Editor, Super Admin. - Perhaps the "_This requires an EE license with a Bronze plan._" sentence could be improved. I think we should write "Enterprise Edition" instead of "EE" to make it clearer. It could also be better to explain that it's at least the Bronze plan that is required (but Silver & Gold also work).