Clarify required scopes documentation

[frankie567]

We had a feedback on Discord wondering why we required both a read and write scope on a read-only operation:

This should be read as an OR, but it's true that it may be misleading. We probably should improve the wording or presentation here.

Notes

• The logic responsible for adding scopes to the docstring is inside DocumentedAuthSubjectAPIRoute class.
• I discovered that we can add JSX component into the docstring and it's correctly interpreted by Mintlify. Maybe there are nice things to do with this.