The docstring should say what a method does and not how it does it.

I think that  „on windows extra path...” should be moved down as a comment (near the windows part)... or refactored to say why we need extra PATHS on windows.

We should try to keep the docstrings as short as possible. Long docstrings are hard to maintain and there is a big risk of getting out of sync with the code.