Are nested visitors really not supported for preprocessors and decorators?

[aviskase]

I've noticed that docs says

Preprocessors and decorators do not support nested visitors.

https://github.com/Redocly/openapi-cli/blob/master/docs/custom-rules.md#L19

But in our preprocessing plugin we successfully use nested visitor Parameter > Schema.

Similarly, in the #294 (comment) there is a PathItem > Operation nested visitor.

Can you confirm that docs are still right and successful usage is accidental (so we shouldn't rely on it)?

[RomanHotsiy]

Can you confirm that docs are still right and successful usage is accidental (so we shouldn't rely on it)?

Preprocessors and decorators use same traversal logic as regular rules but there is caveat that you can modify something and break parent visiting logic. That's why we decided to disallow it in the docs. We're not going to break it I believe so I would be open to change the wording in the docs to warn about potential unexpected behaviour vs saying it's not supported.

I need to refresh my understanding of what can go wrong with nested decorators to be specific in the docs.