ansible icon indicating copy to clipboard operation
ansible copied to clipboard

docs: Update managed node requirements

Open ianw opened this issue 3 years ago • 3 comments

SUMMARY

The managed node links introduced with 2fc73a9dc357e776dbbbfd035c86fe880415e60a aren't valid. This adds an explicit section for the current version supported links, and a historical table for quick reference if you're deciding what versions of Python you need in various places.

Closes: #78423 Co-Authored-By: Matt Martz [email protected]

ISSUE TYPE
  • Docs Pull Request

ianw avatar Aug 08 '22 05:08 ianw

Thanks for your Ansible docs contribution! We talk about Ansible documentation on maxtrix at #docs:ansible.im and on libera IRC at #ansible-docs if you ever want to join us and chat about the docs! We meet there on Tuesdays (see the Ansible calendar) and welcome additions to our weekly agenda items - scroll down to find the upcoming agenda and add a comment to put something new on that agenda.

click here for bot help

ansibot avatar Aug 08 '22 05:08 ansibot

The test ansible-test sanity --test docs-build [explain] failed with 21 errors:

docs/docsite/rst/index.rst:0:0: unknown: 
docs/docsite/rst/index.rst:0:0: unknown:      - Control node Python
docs/docsite/rst/index.rst:0:0: unknown:      - Managed node Python
docs/docsite/rst/index.rst:0:0: unknown:      - Python 2.6 - 2.7, Python 3.5 - 3.10
docs/docsite/rst/index.rst:0:0: unknown:      - Python 2.6 - 2.7, Python 3.5 - 3.9
docs/docsite/rst/index.rst:0:0: unknown:      - Python 2.7, Python 3.5 - 3.10
docs/docsite/rst/index.rst:0:0: unknown:      - Python 2.7, Python 3.5 - 3.11
docs/docsite/rst/index.rst:0:0: unknown:      - Python 2.7, Python 3.5 - 3.9 [#]_
docs/docsite/rst/index.rst:0:0: unknown:      - Python 3.10 - 3.10
docs/docsite/rst/index.rst:0:0: unknown:      - Python 3.8 - 3.10,
docs/docsite/rst/index.rst:0:0: unknown:      - Python 3.9 - 3.11
docs/docsite/rst/index.rst:0:0: unknown:    * - 2.11
docs/docsite/rst/index.rst:0:0: unknown:    * - 2.12
docs/docsite/rst/index.rst:0:0: unknown:    * - 2.13
docs/docsite/rst/index.rst:0:0: unknown:    * - 2.14
docs/docsite/rst/index.rst:0:0: unknown:    * - Version
docs/docsite/rst/index.rst:0:0: unknown:    :header-rows: 1
docs/docsite/rst/index.rst:0:0: unknown: .. list:table::
docs/docsite/rst/index.rst:0:0: unknown: WARNING: unknown directive or role name: list:table
docs/docsite/rst/installation_guide/intro_installation.rst:35:0: warning: Unknown directive type "list:table".
docs/docsite/rst/installation_guide/intro_installation.rst:54:0: warning: Footnote [#] is not referenced.

The test ansible-test sanity --test rstcheck [explain] failed with 1 error:

docs/docsite/rst/installation_guide/intro_installation.rst:35:0: Unknown directive type "list:table".

click here for bot help

ansibot avatar Aug 08 '22 05:08 ansibot

I'm not necessarily against including this now, but eventually (soon) this data will duplicated at https://docs.ansible.com/ansible/devel/reference_appendices/release_and_maintenance.html#ansible-core-changelogs

The goal will be to provide a single table that describes version, support dates, and supported python versions. That section header will probably change as well. I'm still working out some usability concerns on the table, which is why I haven't published it yet.

sivel avatar Aug 09 '22 14:08 sivel

/azp run

webknjaz avatar Aug 10 '22 15:08 webknjaz

Azure Pipelines successfully started running 1 pipeline(s).

azure-pipelines[bot] avatar Aug 10 '22 15:08 azure-pipelines[bot]

Thanks @ianw for the Ansible docs fix! We'll update with pointers once @sivel has the new table ready.

samccann avatar Aug 18 '22 18:08 samccann