Improve documentation for configure_scope()

The current documentation does not make it clear whether this code is permanent or if it is reverted as soon as the with block is exited:

from sentry_sdk import configure_scope

with configure_scope() as scope:
    scope.set_tag("my-tag", "my value")
    scope.user = {'id': 42, 'email': '[e-mail]'}

I assume it is permanent, because if it is not then there would be no difference from push_scope, but it should be made explicit with an example (the opposite of the example given for push_scope would make it clear).

[untitaker]

@aviv-ebates nothing. it will be gone or at least superseded soon. configure_scope is a concept that didn’t translate well to python from other languages

[beaugunderson]

This is the one that contains the counter-example:

https://docs.sentry.io/enriching-error-data/scopes/?platform=python

from sentry_sdk import push_scope, capture_exception

with push_scope() as scope:
    scope.set_tag("my-tag", "my value")
    scope.level = 'warning'
    # will be tagged with my-tag="my value"
    capture_exception(Exception("my error"))

# will not be tagged with my-tag
capture_exception(Exception("my other error"))

Inverting that example would give something like this:

from sentry_sdk import configure_scope, capture_exception

with configure_scope() as scope:
    scope.set_tag("my-tag", "my value")
    scope.level = 'warning'
    # will be tagged with my-tag="my value"
    capture_exception(Exception("my error"))

# will also be tagged with my-tag
capture_exception(Exception("my other error"))