Introduce Ansible Module Collection guide (#3859)

* Unify 'getting help' sections for Hammer, API, and Ansible guides
* Create Ansible Collection guide
* Remove Ansible Module Collection docs from Admin
* Add Ansible Collection guide to navigation (nightly)
* Ensure users first install pkg and then view modules
* Drop playbook template

Co-authored-by: Lena Ansorgová <[email protected]>

Author: aneta-petrova

guides/common/assembly_example-playbooks-based-on-modules-from-project-ansible-collection.adoc

@@ -0,0 +1,7 @@
+:_mod-docs-content-type: ASSEMBLY
+
+include::modules/con_example-playbooks-based-on-modules-from-project-ansible-collection.adoc[]
+
+include::modules/ref_playbook-example-enable-repositories-and-create-a-content-view.adoc[leveloffset=+1]
+
+include::modules/ref_playbook-example-synchronize-repositories-and-publish-a-content-view.adoc[leveloffset=+1]

guides/common/assembly_introduction-to-project-ansible-collection.adoc

@@ -0,0 +1,7 @@
+:_mod-docs-content-type: ASSEMBLY
+
+include::modules/con_introduction-to-project-ansible-collection.adoc[]
+
+include::modules/proc_installing-the-project-ansible-modules.adoc[leveloffset=+1]
+
+include::modules/ref_getting-help-with-project-ansible-collection.adoc[leveloffset=+1]

guides/common/assembly_introduction-to-project-api.adoc

@@ -5,3 +5,5 @@ include::modules/con_introduction-to-project-api.adoc[]
 include::modules/con_overview-of-the-project-api.adoc[leveloffset=+1]
 
 include::modules/con_project-api-compared-to-hammer-cli.adoc[leveloffset=+1]
+
+include::modules/ref_getting-help-with-project-api.adoc[leveloffset=+1]

guides/common/assembly_managing-project-with-ansible-collection.adoc

@@ -1,6 +1,7 @@
 // URLs
 :BaseFilenameURL: index-{build}.html
 :AdministeringDocURL: {BaseURL}Administering_Project/{BaseFilenameURL}#
+:AnsibleDocURL: {BaseURL}Foreman_Ansible_Collection/{BaseFilenameURL}#
 :APIDocURL: {BaseURL}Project_API/{BaseFilenameURL}#
 :IntegratingProvisioningInfrastructureServicesDocURL: {BaseURL}Integrating_Provisioning_Infrastructure_Services/{BaseFilenameURL}#
 :ConfiguringLoadBalancerDocURL: {BaseURL}Configuring_Load_Balancer/{BaseFilenameURL}#

guides/common/attributes-base.adoc

@@ -14,6 +14,7 @@
 // - lib/foreman_theme_satellite/documentation.rb in RedHatSatellite/foreman_theme_satellite
 // - downstream_filename_to_link.json in downstream
 :AdministeringDocURL: {BaseURL}administering_red_hat_satellite/index#
+:AnsibleDocURL: {BaseURL}using_the_satellite_ansible_collection/index#
 :APIDocURL: {BaseURL}using_the_satellite_rest_api/index#
 :ConfiguringDNSDHCPTFTPDocURL: {BaseURL}configuring_dns_dhcp_and_tftp_integration/index#
 :ConfiguringLoadBalancerDocURL: {BaseURL}configuring_capsules_with_a_load_balancer/index#

guides/common/attributes-satellite.adoc

@@ -1,6 +1,7 @@
 // Base for titles
 
 :AdministeringDocTitle: Administering {ProjectName}
+:AnsibleDocTitle: Using the {Project} Ansible Collection
 :APIDocTitle: Using the {Project} REST API
 :AppCentricDeploymentDocTitle: Deploying hosts by using application centric approach
 :IntegratingProvisioningInfrastructureServicesDocTitle: Integrating provisioning infrastructure services

guides/common/attributes-titles.adoc

@@ -6,8 +6,6 @@
 {Project} Ansible Collection is a set of Ansible modules that interact with the {Project} API.
 You can use these modules to automate many aspects of {Project} administration.
 
-ifeval::["{context}" == "planning"]
 .Additional resources
 * For more information about using Ansible to configure hosts, see {ManagingConfigurationsAnsibleDocURL}[{ManagingConfigurationsAnsibleDocTitle}].
 * For more information about automating {Project} using Ansible, see {ManagingConfigurationsAnsibleDocURL}automating-{project-context}-management-with-{project-context}-ansible-collection[Automating {Project} management with {Project} Ansible Collection] in _{AdministeringDocTitle}_.
-endif::[]

guides/common/modules/con_automating-project-management-with-project-ansible-collection.adoc

@@ -0,0 +1,14 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="example-playbooks-based-on-modules-from-{project-context}-ansible-collection"]
+= Example playbooks based on modules from {Project} Ansible Collection
+
+All playbooks based on modules from {Project} Ansible Collection must include parameters detailing how to connect to the {Project} API.
+The following examples use Ansible vault and module defaults group to provide these parameters, and they authenticate using a username and password.
+For more information, see xref:creating-a-playbook-with-modules-from-{project-context}-ansible-collection[].
+
+.Additional resources
+* Use the `ansible-doc --list {ansible-namespace}` command to display the {Project} Ansible modules installed on your system.
+ifndef::orcharhino[]
+* See {ansible-galaxy}[{ansible-galaxy-name}] for a complete list of {Project} Ansible modules and other related information.
+endif::[]

guides/common/modules/con_example-playbooks-based-on-modules-from-project-ansible-collection.adoc

@@ -0,0 +1,7 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="introduction-to-{project-context}-ansible-collection"]
+= Introduction to {Project} Ansible Collection
+
+{Project} Ansible Collection provides a set of Ansible modules for managing {Project}.
+Using the modules, you can automate many aspects of {Project} management.