shutil.rmtree - link to example for windows readonly file handling in function docs

[pmolodo]

Documentation

The python docs for the shutil module include an example of how to use rmtree on a windows folder that contains read-only files:

https://docs.python.org/3/library/shutil.html#rmtree-example

However, there is no mention of this solution, or even that this is a potential issue on windows, within the documentation for the shutil.rmtree function itself:

https://docs.python.org/3/library/shutil.html#shutil.rmtree

As a result, it is likely that many developers miss this as a potential issue or solution. A simple link to the example, within the shutil.rmtree itself, would increase awareness.

Linked PRs

• gh-134538: link to example for windows readonly file handling in function docs #135540