gh-141127: Clarify o?s.symlink() documentation for argument order (#141144)

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index d31d0ce9c85e9ae0b2b18086cc6aab0185325737..dbc3c92c8798b5e13307e3572b1327c537ff1da0 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -3873,6 +3873,9 @@ features:
 
    Create a symbolic link pointing to *src* named *dst*.
 
+   The *src* parameter refers to the target of the link (the file or directory being linked to),
+   and *dst* is the name of the link being created.
+
    On Windows, a symlink represents either a file or a directory, and does not
    morph to the target dynamically.  If the target is present, the type of the
    symlink will be created to match. Otherwise, the symlink will be created