bpo-36182: Update pathlib.Path.write_text() docs (GH-12161)

with the case of an existing file
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index d33e2d0..acbd0e4 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1119,6 +1119,9 @@
       >>> p.read_text()
       'Text file contents'
 
+   An existing file of the same name is overwritten. The optional parameters
+   have the same meaning as in :func:`open`.
+
    .. versionadded:: 3.5
 
 Correspondence to tools in the :mod:`os` module