Document behavior of Path.symlink_to() when source already exists

Documentation

The documentation for Path.symlink_to() [1] does not mention what happens when the source already exists, e.g.:

>>> from pathlib import Path
>>> Path("source").symlink_to("target1")
>>> Path("source").symlink_to("target2")
Traceback (most recent call last):
  File "<python-input-2>", line 1, in <module>
    Path("source").symlink_to("target2")
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
  File "/usr/lib/python3.13/pathlib/_local.py", line 789, in symlink_to
    os.symlink(target, self, target_is_directory)
    ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileExistsError: [Errno 17] File exists: 'target2' -> 'source'

(The same applies to os.symlink [2] by the way)

Linked PRs

• gh-132704
• gh-132810

Empieza por la documentación de pathlib.Path.symlink_to() enlazada en el issue y, después, compara la documentación de os.symlink() para el mismo comportamiento. Se considera terminado cuando ambas entradas explican qué ocurre cuando la ruta de destino ya existe, incluido el ejemplo de FileExistsError mostrado aquí.