###### tags: `Documentation` # Ansible docs publishing process This document provides an audit of the Jenkins jobs that publish Ansible content and update the docsite at `docs.ansible.com`. Documentation source for `docs.ansible.com`: - https://github.com/ansible/ansible/tree/devel/docs/docsite - https://github.com/ansible/product-docs - https://github.com/ansible/docsite ## AAP Jenkins This section describes the jobs that run on the AAP Jenkins instance. Build_Ansible_Package_Docs Builds the Ansible package documentation. This is Ansible core + the collections. Migrated from Ansible Eng Jenkins. Build_Ansible_Package_Docs_Automated Periodically builds the default branch from git HEAD to docs.ansible.com/ansible-core/devel/ Includes core and all collections. Migrated from Ansible Eng Jenkins. Build_AWX_Cli_Docs Builds Controller CLI docs at: https://docs.ansible.com/automation-controller/latest/html/controllercli/ Migrated from Ansible Eng Jenkins. Build_Docsite Builds static pages and layout for docs.ansible.com from the ansible/docsite repo. Duplicate job on Ansible Eng Jenkins. Build_Tower_Swagger_Docs Builds swagger.json and commits it to ansible/product-docs/controllerapi/source/_swagger/. Sync_Release_Mirrors Performs an rsync of content from the docs/releases master to the docs/releases mirrors. Basically synchronizes content to ec2 vms. ## Ansible Eng Jenkins This section describes the jobs that run on the Ansible Eng Jenkins instance. Build_210_docs Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation. Build_Ancient_Docs Builds legacy documentation for Ansible 2.3 and 2.4. Details in Building Ancient Ansible Docs Build_Ansible_Core_Docs_Automated Periodically builds the default branch from git HEAD to docs.ansible.com/ansible-core/devel/ Includes core and the builtin collections. Build_Ansible_Docs Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation. Build_Ansible_Package_Docs No longer in use. Migrated to AAP Jenkins. Build_Ansible_Package_Docs_Automated No longer in use. Migrated to Ansible Eng Jenkins. Build_AWX_CLI_Docs No longer in use. Migrated from Ansible Eng Jenkins. Build_Docsite Builds static pages and layout for docs.ansible.com from the ansible/docsite repo. Duplicate job on AAP Jenkins. Build_Tower_Docs Builds Controller documentation at: https://docs.ansible.com/automation-controller/latest/ Documentation - Backport job Cherry-picks commits between branches in the ansible/product-docs repository. Test-centos9 Builds legacy documentation for pre-collections versions (<2.10) and/or ansible-core documentation.