Commit Graph

4263 Commits

Author SHA1 Message Date
Andrew Klychkov
e0a6dfc0c9 porting_guide_core_2.19.rst: add clatifications on the required non-string key conversion (#2560)
* porting_guide_core_2.19.rst: add clatifications on the required non-string key conversion

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

* Add an example how to convert

* Add example

* Change example

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Matt Clay <matt@mystile.com>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Matt Clay <matt@mystile.com>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Matt Clay <matt@mystile.com>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Matt Clay <matt@mystile.com>

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Matt Clay <matt@mystile.com>
2025-04-25 09:33:21 +01:00
Mario Lenz
9424c8cdd0 Update Ansible 12 porting guide for 12.0.0a2 release (#2562)
* Update Ansible 12 porting guide for 12.0.0a2 release

* Update porting guide.

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-04-24 20:13:32 +02:00
Lyle McKarns
e1c5a62ae2 Update example image from fedora:39 to fedora:42 (#2541)
* Manually defined python package, swapped to main fedora registry, bumped version to fedora 42

---------

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2025-04-24 08:56:52 +01:00
Andrew Klychkov
c268b80df5 Update developing_modules_documenting.rst (#2551) 2025-04-23 11:19:56 -04:00
Matt Clay
c96208170c Additional porting guide entries (#2531)
* Additional porting guide entries

* Restore list formatting
2025-04-23 11:18:59 -04:00
Mario Lenz
10a6846544 Update Ansible 11 porting guide for 11.5.0 release (#2547) 2025-04-22 19:39:15 +02:00
Felix Fontein
144b00b04e Apply porting guide fix. (#2532) 2025-04-18 11:41:00 +02:00
Andrew Klychkov
6e8c4bd633 Module format and doc: tidy up (#2502)
* developing_modules_documenting.rst: tidy up

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-04-17 13:59:09 +01:00
Mario Lenz
d271a27815 Add porting guide for Ansible 12.0.0a1 (#2527)
* Add porting guide for Ansible 12.0.0a1

* Update porting guide.

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-04-16 20:47:32 +02:00
Don Naro
df76b40158 Update core support matrix 2.19 (#2524)
* update core support matrix 2.19

* fix formatting and GA date

* Update docs/docsite/rst/reference_appendices/release_and_maintenance.rst

Co-authored-by: Matt Martz <matt@sivel.net>

* Update docs/docsite/rst/reference_appendices/release_and_maintenance.rst

Co-authored-by: Maxwell G <maxwell@gtmx.me>

* add reference to changelog

---------

Co-authored-by: Matt Martz <matt@sivel.net>
Co-authored-by: Maxwell G <maxwell@gtmx.me>
2025-04-16 19:37:17 +02:00
Matt Davis
f8babd7574 WIP 2.19 Porting Guide stub with data tagging (#2429)
* WIP 2.19 Porting Guide stub with data tagging

* Add another multi-pass templating example

* Add example for unintentional string conversion

* Add blank lines after code blocks

* Fix heading type

* Attempt to fix warnings

* add conditional syntax error example

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Maxwell G <maxwell@gtmx.me>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Maxwell G <maxwell@gtmx.me>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Maxwell G <maxwell@gtmx.me>

* Update docs/docsite/rst/porting_guides/porting_guide_core_2.19.rst

Co-authored-by: Maxwell G <maxwell@gtmx.me>

* Refresh DT porting guide for 2.19.0b1
* misc reorder, wordsmith
* address review feedback

* Apply suggestions from code review

Update capitalization and quoting.

Co-authored-by: Sandra McCann <samccann@redhat.com>

* Apply suggestions from code review

Co-authored-by: Sandra McCann <samccann@redhat.com>

* Apply suggestions from code review

---------

Co-authored-by: Matt Clay <matt@mystile.com>
Co-authored-by: Maxwell G <maxwell@gtmx.me>
Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-04-16 13:23:22 -04:00
Felix Fontein
7388168517 Adjust Ansible 12 roadmap. (#2508) 2025-04-12 10:59:35 +02:00
Matt Martz
91949dc4f2 2.19 roadmap updates (#2497) 2025-04-09 12:14:42 -05:00
Conner Crosby
5af6180bed Add missing closing parentheses (#2467) 2025-03-27 15:26:42 +00:00
Don Naro
0591b5f98c Fix codespell issues (#2478)
* add entries to codespell ignored words list

* fix spelling issues
2025-03-27 11:56:32 +00:00
Felix Fontein
3c4b158425 Add Ansible 11.4.0 porting guide. (#2468) 2025-03-25 20:20:16 +01:00
Sandra McCann
d78d2a5266 add fest banner (#2464) 2025-03-21 15:09:51 -04:00
Felix Fontein
c7c3eea9dc Add yamllint check for RST code listings (#2385)
* Add yamllint check for RST code listings.

* Address review comments.

* Sort languages and remove no longer needed duplicates.

* Enable warnings, but disable all failing rules.

* Improve formulation.

Co-authored-by: Don Naro <dnaro@redhat.com>

* Show allowed languages when no or invalid language is supplied. Improve line lengths.

* Make sure that 'yamllint .' passes.

* Fix indentation issues introduced in #2095.

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
2025-03-21 19:41:40 +01:00
Yacht Shaver
6267d1a67b Recommend madbg instead of epdb (#2428)
epdb doesn't work anymore in Python 3.13 because it requires telnetlib
which was removed from Python's stdlib in 3.13
2025-03-20 16:38:26 -04:00
Sandra McCann
dbae0ce87d fix label warnings (#2417)
* fix broken links

* fix some more label problems

* Apply suggestions from code review

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-03-20 16:37:10 -04:00
Abhijeet Kasurde
20511dd878 Update module developement (#2427)
* Update module developement

* Updated developer guide for module development to work with
  collection and PYTHONPATH

Fixes: #2374

Signed-off-by: Abhijeet Kasurde <Akasurde@redhat.com>

* Apply suggestions from code review

Co-authored-by: Don Naro <dnaro@redhat.com>
Signed-off-by: Abhijeet Kasurde <Akasurde@redhat.com>

---------

Signed-off-by: Abhijeet Kasurde <Akasurde@redhat.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
2025-03-20 16:36:48 -04:00
Martin Krizek
152e29dd8b Porting guide entry for become timeout is unreachable error (#2421) 2025-03-20 16:34:41 -04:00
Klaus Frank
6af93add2d union filter documented incorrectly (#2403)
* union documented incorrectly

The invalid documentation of union was fixed in https://github.com/ansible/ansible/issues/82199 but didn't populate into this section of the docs.

* Apply suggestions from code review

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-03-20 16:28:10 -04:00
Brian Coca
cc9853ce76 fixes and updates to inventory intro (#2416)
* fixes and updates to inventory intro

* Apply suggestions from code review

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>

* fix typo

* fix vars plugin refs

* example

* Update docs/docsite/rst/inventory_guide/intro_inventory.rst

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>

---------

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
2025-03-20 16:25:38 -04:00
S1ructure
19c3ffa9ff Update playbooks_error_handling.rst (#2095)
* Update playbooks_error_handling.rst

Add example for using own variables in conditions

* Apply suggestions from code review

Co-authored-by: Don Naro <dnaro@redhat.com>

---------

Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
2025-03-20 16:15:48 -04:00
Ketan Kelkar
ac0bf97e05 Introduce a new section for managing z/OS UNIX mainframe hosts with Ansible. (#2424)
* add a new page for managing unix(zos) hosts

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* update unix(zos) faq section

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* update references from z/OS to z/OS UNIX for clarity; capitalize instances of 'Python'

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* specify 'ansible.builtin modules' instead of 'community modules', update section headers to use sentence-case

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* missed a few 'community' where 'ansible.builtin' belongs

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* update to correct terminology

Co-authored-by: Sandra McCann <samccann@redhat.com>

* add links to builtin modules

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* sytax and punctation edits

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

* fix a bad link

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>

---------

Signed-off-by: Ketan Kelkar <ktnklkr@gmail.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-03-20 15:46:35 -04:00
Andrew Klychkov
350ef3df2c testing_sanity.rst: improvement (#2441)
* testing_sanity.rst: improvement

* Add collection specific remarks

* Change suggested
2025-03-18 11:26:23 -04:00
Matt Martz
8555ab6923 Add core 2.19 porting guide (#2373) 2025-03-17 16:45:31 -04:00
Mario Lenz
70d257d4fb Involuntarily leaving SC: Allow PM on forum (#2393)
* Involuntarily leaving SC: Allow PM on forum

* Suggestion from felixfontein

* Allow CoC violations via PM

* Revert "Allow CoC violations via PM"

* Send email as a last resort

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-03-16 15:55:50 +01:00
Mario Lenz
7ff911e237 Remove thaumos from SC (#2440) 2025-03-11 13:59:31 +00:00
Mario Lenz
fed75be32b Update Ansible 11 porting guide for 11.3.0 release (#2425) 2025-02-25 13:38:59 -05:00
Sandra McCann
7082b5ded5 address broken links in dev and appendices sections (#2402)
* fix some broken links

* malformed link

* Update docs/docsite/rst/dev_guide/developing_python_3.rst

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>

* Apply suggestions from code review

Co-authored-by: Don Naro <dnaro@redhat.com>

---------

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
2025-02-24 17:14:23 +00:00
Felix Fontein
d8c36a014f Fix YAML syntax, adjust more code block languages (#2408)
* Fix broken YAML, or adjust code block type.

* Normalize code block type.
2025-02-14 22:06:37 +01:00
Felix Fontein
8d5838892a Fix broken link markup. (#2412) 2025-02-12 15:00:09 -05:00
Don Naro
7eb7a3a8d2 Update RST files to specify codeblock language attributes (#2382)
* Update RST files to specify codeblock language attributes

Co-authored-by: Ganesh Hubale <25399590+ganeshhubale@users.noreply.github.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Felix Fontein <felix@fontein.de>

* change lexer names to fix ci

* yaml is yaml not ini

* Update docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* yamllint codeblock

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* yamlgit add .

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

* Update docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

* Update docs/docsite/rst/dev_guide/developing_collections_creating.rst

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

* Update docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

* Update docs/docsite/rst/os_guide/intro_bsd.rst

Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>

---------

Co-authored-by: Ganesh Hubale <ganeshhubale03@gmail.com>
Co-authored-by: Ganesh Hubale <25399590+ganeshhubale@users.noreply.github.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Felix Fontein <felix@fontein.de>
2025-02-12 18:53:35 +01:00
Abhijeet Kasurde
857de64d3b intro_inventory: Update ignore extension setting (#2372)
* Updated docs about ignored extension settings as inventory
  sources.

Fixes: #1899

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2025-02-05 12:05:52 -05:00
Martin Krizek
fcdb006e0f Clarify handlers insertion order (#2359)
* Clarify handlers insertion order

* Update docs/docsite/rst/playbook_guide/playbooks_handlers.rst

Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com>

---------

Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com>
2025-02-05 12:02:42 -05:00
Mario Lenz
552e9fe800 Add SC member forum names (#2392) 2025-02-05 12:00:52 -05:00
Felix Fontein
f9514729a3 Remove incorrect parts from docs. (#2388) 2025-02-04 12:34:01 +00:00
Felix Fontein
634e6d035d Update Ansible 11 porting guide for 11.2.0 release. (#2380) 2025-01-28 20:20:14 +01:00
Don Naro
8d8047741c Remove the relaxed requirements (#2353)
* rm relaxed requirements

* rm base constraints file

* update requirements input file

* sync requirements lock file

* update noxfile to rm relaxed reqs

* update pip-compile workflow to rm relaxed reqs

* update docs

* fix noxfile issues

* tidy up pins and reqs

* Update tests/constraints.in

Co-authored-by: Felix Fontein <felix@fontein.de>

* add all version ranges to constraints

* Update tests/requirements.in

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update tests/constraints.in

Co-authored-by: Felix Fontein <felix@fontein.de>

* sync req lock file

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-01-17 09:40:41 +00:00
David Mann
277aaca9a4 add runpip instructions for dependencies (#2322)
* add runpip instructions for dependencies

* Update docs/docsite/rst/installation_guide/intro_installation.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
2025-01-14 17:30:33 +00:00
Andrew Klychkov
3db40ccffa How Can I Help? page: add a ref to collections quick-start guide (#2346)
* How Can I Help? page: add a ref to collections quick-start guide

* Update docs/docsite/rst/community/how_can_I_help.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
2025-01-14 11:10:56 +00:00
atcorduneanu
cab5ad1e07 Update platform_junos.rst (#2141)
* Update platform_junos.rst

junos_ping also works only with ansible.netcommon.network_cli

* Update docs/docsite/rst/network/user_guide/platform_junos.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
2025-01-10 15:53:01 -05:00
Brian Coca
8e817dc5a0 callback event reception order (#2333)
* callback event reception order

* Update docs/docsite/rst/plugins/callback.rst

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>

---------

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
2025-01-10 13:40:48 -05:00
Ganesh Hubale
8e331e4b16 fix(style-guide): Add definition for "ID" abbreviation in spelling and word choice guide (#2332)
- Added entry for "ID" (Identification/Identifier) to the spelling and word choice guide.
- Clarified correct usage as "ID" (all uppercase) and specified avoiding variations like "Id" or "id".
- Provided examples and reasoning for consistent capitalization.

Resolves: ansible/ansible-documentation#2326

Signed-off-by: Ganesh Hubale <ganeshhubale03@gmail.com>
2025-01-10 13:39:10 -05:00
Sandra McCann
07c85f98a6 remove 2.9 from version switcher (#2329) 2025-01-07 11:56:37 -05:00
Pavel Knoblokh
c98ac617b1 intro_bsd: Update docs for the current FreeBSD and OpenBSD (#2318) 2025-01-07 12:28:48 +00:00
Andrew Klychkov
fd41e24701 [Needs SC review] community/other_tools_and_programs.rst: update (#2284)
* community/other_tools_and_programs.rst: update

* Add a link to Awesome Ansible for editors info

* Fix

* Update docs/docsite/rst/community/other_tools_and_programs.rst

Co-authored-by: Sandra McCann <samccann@redhat.com>

* Add SC as codeowners

* Fix

---------

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-12-18 09:30:56 -05:00
Mario Lenz
7e6cb4c50a Ansible 12 roadmap (#2252)
* Ansible 12 roadmap

* Fix C&P error

Co-authored-by: Felix Fontein <felix@fontein.de>

* Suggestion from felixfontein

Co-authored-by: Felix Fontein <felix@fontein.de>

* Update some links

Co-authored-by: Felix Fontein <felix@fontein.de>

* Suggestion from acozine

Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>

* Fix typo

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
2024-12-17 18:24:12 +01:00