Docstring for pathlib.Path.walk isn't very helpful #142290
Description
Documentation
Currently, the docstring for pathlib.Path.walk doesn't actually describe the functionality itself, merely referring to os.walk. This makes using it a bit less convenient, since one can't work out from the docstring alone how to use it. The docstring should describe the triples that the function yields, and maybe os.walk's docstring should refer to pathlib.Path.walk as well in order to encourage use of the new interface.