Added try-except-raise message example

[matusvalo]

Type of Changes

	Type
	🐛 Bug fix
	✨ New feature
	🔨 Refactoring
✓	📜 Docs

Description

Related #5953

[jacobtylerwalls]

Thanks. Is details.rst a good place to summarize the discussion from #5884 (comment) involving filtering exceptions? [EDIT: I suppose it might be a good idea to add an example with filtering of exceptions.]

[Pierre-Sassoulas]

I agree that we should add a detail.rst, to be clear that there's a legitimate use case for re raising immediately but that this check is smart enough to not have a false positive for it.

I.e. with the following inheritance tree:

      +-- ArithmeticError
      |    +-- FloatingPointError
      |    +-- OverflowError
      |    +-- ZeroDivisionError

try:
    some_calculation(...)
except ZeroDivisionError as e:
    raise
except ArithmeticError:
   pass

will not get a pylint warning because ZeroDivisionError inherit from ArithmeticError.

[matusvalo]

Added details.rst. Please review if now it is OK.

[Pierre-Sassoulas]

👍