corrected import_play into to import_playbook (#30853)

* corrected import_play into to import_playbook

fixes #30744

(cherry picked from commit 17f094bb6a)

CHANGELOG.md

@@ -48,8 +48,9 @@ Ansible Changes By Release
 * Fix vault errors after 'ansible-vault edit' (https://github.com/ansible/ansible/issues/30575)
 * updated api doc example to match api changes
 * corrected issues with slack callback plugin
+* it is import_playbook .. not import_plays .. docs now reflect this
 
-<a id="2.4"></a>
+<sdfasdfsadfsdflkjsdfklj3oiqrua id="2.4"></a>
 
 ## 2.4 "Dancing Days" - ACTIVE DEVELOPMENT
 

docs/docsite/rst/playbooks_best_practices.rst

@@ -221,8 +221,8 @@ some other playbooks::
 
     ---
     # file: site.yml
-    - import_plays: webservers.yml
-    - import_plays: dbservers.yml
+    - import_playbook: webservers.yml
+    - import_playbook: dbservers.yml
 
 In a file like webservers.yml (also at the top level), we map the configuration of the webservers group to the roles performed by the webservers group::
 

docs/docsite/rst/roadmap/ROADMAP_2_4.rst

@@ -128,7 +128,7 @@ Runtime Check on Modules for Blacklisting
 
 Disambiguate Includes
 ---------------------
-- Create import_x for 'static includes' (import_task, import_play, import_role)
+- Create import_x for 'static includes' (import_task, import_playbook, import_role)
 
   - Any directives are applied to the 'imported' tasks
 

lib/ansible/modules/utilities/logic/_include.py

@@ -20,7 +20,7 @@ module: include
 short_description: include a play or task list.
 deprecated:
     The include action was too confusing, dealing with both plays and tasks, being both dynamic and static.  This module will be removed in version 2.8.
-    As alternatives use include_tasks, import_plays, import_tasks.
+    As alternatives use include_tasks, import_playbook, import_tasks.
 description:
      - Includes a file with a list of plays or tasks to be executed in the current playbook.
      - Files with a list of plays can only be included at the top level, lists of tasks can only be included where tasks normally run (in play).

lib/ansible/modules/utilities/logic/import_playbook.py

@@ -16,7 +16,7 @@ DOCUMENTATION = '''
 ---
 author:
     - "Ansible Core Team (@ansible)"
-module: import_plays
+module: import_playbook
 short_description: import a playbook.
 description:
      - Includes a file with a list of plays to be executed.
@@ -37,7 +37,7 @@ EXAMPLES = """
     - debug:
         msg: "play1"
 
-- import_plays: otherplays.yml
+- import_playbook: otherplays.yml
 
 
 - name: This DOES NOT WORK
@@ -47,7 +47,7 @@ EXAMPLES = """
         msg: task1
 
     - name: This failes because I'm inside a play already
-      import_plays: stuff.yml
+      import_playbook: stuff.yml
 """
 
 RETURN = """