Documentation

The python docs for theshutil module include an example of how to usermtree 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 theshutil.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 theshutil.rmtree itself, would increase awareness.