Update docs based on 23946 (#25860)

* Update docs based on 23946

Original PR https://github.com/ansible/ansible/pull/23946

* files/copy.py is now clean

lib/ansible/modules/files/copy.py

@@ -29,7 +29,9 @@ module: copy
 version_added: "historical"
 short_description: Copies files to remote locations.
 description:
-     - The C(copy) module copies a file on the local box to remote locations. Use the M(fetch) module to copy files from remote locations to the local box. If you need variable interpolation in copied files, use the M(template) module.
+    - The C(copy) module copies a file from the local or remote machine to a location on the remote machine.
+      Use the M(fetch) module to copy files from remote locations to the local box.
+      If you need variable interpolation in copied files, use the M(template) module.
 options:
   src:
     description:
@@ -144,6 +146,12 @@ EXAMPLES = '''
     src: /mine/sudoers
     dest: /etc/sudoers
     validate: 'visudo -cf %s'
+
+# Copy a "sudoers" file on the remote machine for editing
+- copy:
+    remote_src: true
+    src: /etc/sudoers
+    dest: /etc/sudoers.edit
 '''
 
 RETURN = '''

test/sanity/pep8/legacy-files.txt

@@ -118,7 +118,6 @@ lib/ansible/modules/database/postgresql/postgresql_user.py
 lib/ansible/modules/database/vertica/vertica_user.py
 lib/ansible/modules/files/acl.py
 lib/ansible/modules/files/archive.py
-lib/ansible/modules/files/copy.py
 lib/ansible/modules/files/synchronize.py
 lib/ansible/modules/files/tempfile.py
 lib/ansible/modules/files/unarchive.py