Missing documentation on layout.operator_context

The property is being used all over the place in blender startup / ui python modules.
Yet the official documentation does not give you any hint on how to when and why you would want to use the existing enum.


Please add required information to the documentation. TIA!