Updated flows documentation to match the implementation

Documentation about the new way of handling the `access_mode=organization` flows. Should match the current implementation => can be merged.

The documentation is quite minimal and the concept itself is not very easy to grasp. Any help in formatting and improving the readability is appreciated.