ansible/docs/docsite
Rick Elrod 2ad10ffe43 hostname: Make strategies consistent, drop py2.4
Change:
- Make strategies behave consistently and return the empty string
  instead of "UNKNOWN" (or "temporarystub") for the "before" value if
  the permanent hostname file does not exist or could not be read.
- Switch to `with open()` instead of annoying exception handling code
  (which was wrong and leaked file handles in several places). This
  drops Python 2.4 support for this module.
- Updated porting guide since users could be relying on these former,
  inconsistent values.

Signed-off-by: Rick Elrod <rick@elrod.me>
2021-05-27 13:15:52 +02:00
..
_extensions More boilerplate fixes. (#70224) 2020-06-22 19:05:30 -07:00
_static lighten navigation background to make section labels easier to read for core docs (#74356) 2021-04-22 13:54:27 -05:00
_themes/sphinx_rtd_theme Fix issue with version 3 in docs version list (#74089) 2021-04-19 18:33:35 +02:00
js/ansible
rst hostname: Make strategies consistent, drop py2.4 2021-05-27 13:15:52 +02:00
sphinx_conf update conf.py (#74751) 2021-05-18 15:34:43 -05:00
.gitignore fix rstcheck problem and gitignore collections dir (#70764) 2020-07-21 15:59:56 -05:00
.nojekyll
ansible_2_5.inv updates intersphinx references for docs links (#71921) 2020-09-25 10:33:29 -05:00
ansible_2_6.inv updates intersphinx references for docs links (#71921) 2020-09-25 10:33:29 -05:00
ansible_2_7.inv updates intersphinx references for docs links (#71921) 2020-09-25 10:33:29 -05:00
ansible_2_8.inv Jinja intersphinx should point at 3.0; other updates 2021-05-12 10:08:00 -07:00
ansible_2_9.inv update intersphinx links for Ansible 3 2021-04-12 14:53:11 -07:00
ansible_2_10.inv Jinja intersphinx should point at 3.0; other updates 2021-05-12 10:08:00 -07:00
ansible_3.inv Jinja intersphinx should point at 3.0; other updates 2021-05-12 10:08:00 -07:00
collection-plugins.yml Collections docs generation (#59761) 2020-07-17 13:07:35 -07:00
jinja2.inv Jinja intersphinx should point at 3.0; other updates 2021-05-12 10:08:00 -07:00
Makefile Update docs on working on docs (#74201) 2021-04-21 15:15:27 -04:00
Makefile.sphinx Documentation: Lay the ground for i18n work. (#73746) 2021-03-05 09:31:56 -08:00
modules.js
python2.inv Add a script to update the intersphinx inventory (#66646) 2020-01-22 17:20:02 -05:00
python3.inv Jinja intersphinx should point at 3.0; other updates 2021-05-12 10:08:00 -07:00
README.md Adds FAQ and other pointers for collections (#71606) 2020-09-09 13:16:26 -04:00
requirements.txt pin docutils to 0.16 until theme problem is fixed (#74193) 2021-04-08 13:37:00 -05:00
variables.dot

Ansible documentation

This project hosts the source behind the general pages of docs.ansible.com. Module-specific documentation is hosted in the various collections repositories. See Ansible Galaxy, the list of Ansible-maintained collections, and the ansible-collections organization for collections sources.

To create clear, concise, and consistent contributions to Ansible documentation, please refer to the following information.

Contributions

Contributions to the documentation are welcome.

The Ansible community produces guidance on contributions, building documentation, and submitting pull requests, which you can find in Contributing to the Ansible Documentation.

You can also join the Docs Working Group and/or the #ansible-docs channel on freenode IRC.

Ansible style guide

Ansible documentation is written in ReStructuredText(RST). The Ansible style guide provides linguistic direction and technical guidelines for working with reStructuredText, in addition to other resources.

Tools

The Ansible community uses a range of tools and programs for working with Ansible documentation. Learn more about Other Tools and Programs in the Ansible Community Guide.

GitHub

Ansible documentation is hosted on the Ansible GitHub project and various collection repositories, especially those in the ansible-collections organization. For general GitHub workflows and other information, see the GitHub Guides.