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

Bắt đầu với tài liệu về pathlib.Path.symlink_to() được liên kết trong issue, sau đó so sánh tài liệu về os.symlink() cho cùng hành vi đó. Công việc được xem là hoàn tất khi cả hai mục đều giải thích điều gì xảy ra khi đường dẫn đích đã tồn tại, bao gồm cả ví dụ FileExistsError được hiển thị ở đây.