Commit Graph

54878 Commits

Author SHA1 Message Date
Sandra McCann
caa2399fa4 add details on some plugin options - AI-assisted (#2813)
* add details on some plugin options

* revise based on feedback

* Apply suggestions from code review

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

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

* Apply suggestions from code review

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

* add examples

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

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

* Apply suggestions from code review

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
2025-07-24 09:23:53 -04:00
Sandra McCann
8b3818d741 Styleguide update for installation_distros.rst - AI-assisted (#2855)
* cursor-ai assisted style edits

* ai-assist - clarified sections

* Apply suggestions from code review

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>

* Apply suggestion from @Andersson007

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>

---------

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
2025-07-23 12:32:39 -04:00
flowerysong
0ff051715e porting guide 2.19: document range() changes (#2832)
Signed-off-by: Paul Arthur <paul.arthur@flowerysong.com>
2025-07-23 12:14:32 -04:00
Sandra McCann
2051b5d390 update backport instructions (#2886) 2025-07-23 12:02:35 -04:00
Andrew Klychkov
da9f871600 release_and_maintenance.rst: reflect that 2.16 is EOL (#2770)
* release_and_maintenance.rst: reflect that 2.16 is EOL

release_and_maintenance.rst: reflect that 2.16 is EOL

* update EOL date to july

---------

Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-07-23 10:39:26 -04:00
flowerysong
913d397a79 porting guide 2.19: nicer rendering for Ansible output (#2877)
Signed-off-by: Paul Arthur <paul.arthur@flowerysong.com>
2025-07-23 10:03:12 -04:00
Felix Fontein
4ae2365276 Fix indent for other keys like :Version Added:. (#2880) 2025-07-23 14:18:19 +02:00
ansible-documentation-bot[bot]
eca228b3ba Add the Ansible community 12.0.0b1 porting guide (#2876)
Co-authored-by: Traythedev <24616310+traytorous@users.noreply.github.com>
2025-07-22 18:59:01 +01:00
Sayanta Banerjee
0514c9d8f8 Fixed minor grammatical errors (#2867) 2025-07-22 11:42:16 -04:00
Andrew Klychkov
4f1bbe8b91 dev_guide/style_guide/spelling_word_choice.rst: See vs Refer to (#2868) 2025-07-22 08:06:26 -04:00
Anwesha Das
05eed3e861 Fixes #2830 uses actions/create-github-app-token@v2 (#2831)
* Fixes #2830 uses actions/create-github-app-token@v2

* Adds github-bot as environment in the job config

* Remove extraneous newline

---------

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2025-07-21 16:15:27 -05:00
Felix Fontein
768ed198da Ansible configuration: improve deprecation messages (#2823)
* Improve config deprecation messages.

* Update formulations according to review comments.
2025-07-21 22:14:04 +02:00
Felix Fontein
180ef733e6 Code block languages: normalize casing of yaml and yaml+jinja, update list in style guide, add comments to keep lists in sync (#2848)
* Update lists of allowed languages.

* Stick to one casing of yaml and yaml+jinja.

* Add comment to keep lists in sync.
2025-07-21 21:49:01 +02:00
Felix Fontein
aadd2dca8e Update removal/readd processes to refer to the documentation of ansible-build-data (#2821)
* Update removal/readd processes to refer to the documentation of ansible-build-data.

* Fix typo.
2025-07-21 14:42:54 -04:00
Sandra McCann
1976c8edec core-2.19 prep - update versioning (#2810) 2025-07-21 14:16:51 -04:00
Andrew Klychkov
953a581e44 inventory_guide/intro_inventory.rst: improve style. Assisted-by AI (#2834)
* inventory_guide/intro_inventory.rst: improve style. Assisted-by AI

* Some manual human-in-the-loop fixes

* Fix

* Fix

* Fix indentation
2025-07-21 11:20:56 -04:00
Sloane Hertel
2c0cb48d57 porting guide 2.19 - describe lazy complex var eval impact on builtin filters/tests (#2639)
* porting guide 2.19 - describe lazy complex variable evaluation impact for common Jinja2 filters/tests

* remove unlikely example

* Fix terminology

* dnaro suggestion: add comments

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

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

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

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

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

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

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

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

* Remove 'embedded template' phrasing and remove quotation marks around variable for consistency with other comments

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Felix Fontein <felix@fontein.de>
2025-07-21 14:56:54 +01:00
ansible-documentation-bot[bot]
5c15f5c356 ci: refresh dev dependencies (#2842)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-21 12:21:47 +01:00
Alex Willmer
ed933eab23 Correct year of contingency date to create ansible-build-data for Ansible 13 (#2846) 2025-07-20 15:08:42 +02:00
ansible-documentation-bot[bot]
e7421d17cc [devel] ci: refresh docs build dependencies (#2838)
* Bump antsibull-docs to 2.19.0.

* ci: refresh docs build dependencies

* Bump version to 2.19.1.

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-18 17:31:14 +01:00
John Barker
0b8d80acef Add more International Communities (#2833)
* Add more International Communities

* Fix typo
2025-07-18 11:05:44 +02:00
Anwesha Das
c78ccaf85d Merge pull request #2825 from anweshadas/pr_porting_guide_11.8.0
Adds Porting Guide for 11.8.0
2025-07-16 17:10:06 +02:00
Anwesha Das
1ef3bd836b Adds Porting Guide for 11.8.0 2025-07-16 16:24:49 +02:00
Andrew Klychkov
06427c38a4 community/maintainers_guidelines.rst: improve the document. Assisted-by: Gemini (#2808)
* community/maintainers_guidelines.rst: improve the document. Assisted-by: Gemini

* Misc fixes
2025-07-16 13:21:54 +02:00
Sandra McCann
cad6ff6202 Moves boolean table to module docs (#2812)
* Add 'True' string

Requested to add `True` string to the Truthy values list.

(cherry picked from commit 332beea50cf87eb698dc96dd981834c9b5357c5e)

* move bool table to module docs

(cherry picked from commit d0a7ed89b391e996a07b448c6c671a9c5c75d371)

* move bool table to module docs
2025-07-15 09:59:06 +01:00
ansible-documentation-bot[bot]
c12d162b47 ci: refresh dev dependencies (#2803)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-15 09:54:07 +01:00
Felix Fontein
51ee33e263 Use antsibull-docutils 1.2.0 to simplify rst-yamllint checker. (#2745) 2025-07-14 22:00:38 +02:00
Anwesha Das
efb5f3e7dc Initial (GHA) Workflow for creating the Porting Guide (#121)
* Adds intial workflow for Porting Guide PR

* Fixes the directory for the ansible documentation checkout

* Fixes the directory for the new branch

* Fixes the EOF error with qouting

* Add steps to check what is there inside a directory

* Edits the tar command

* Fixes ansible versioning for Porting Guide

* Fixes tar command for debuging

* Fixes directory for PR

* Fixes the names of the steps

* Updates to the correct barnch

* Fixes changes based on the review feedback

Fixes changes based on the review feedback

Updates based on the feedback

* Cleans git and github steps for better security

Provides secrets only in the necessary steps.
Uses `--body-file` to `gh pr` command.

* Edits to get Porting guide from ansible-build-data git repo

* Checks out correct repo

* Edits to retrive major version from user input

* Removes redundant quote from PR text

* Reformts abd general cleanup

* Edits to working-directory

* Updates based on feedback

* Update .github/workflows/docsbuild-release.yaml

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

* release porting guide workflow

* use a reusable workflow

* use plain git cmds instead of gha

* More updates based on review feedback

* Updates based on latest review feedback

* Update .github/workflows/reusable-porting-guide.yml

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

* Update .github/workflows/reusable-porting-guide.yml

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

* Update .github/workflows/reusable-porting-guide.yml

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

* Update .github/workflows/reusable-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Uses single workflow file

Fetching porting guide from the ansible-build-data repo from
the release PR branch.
Creating Porting Guide PR using rst file.

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Creates draft PR

* Updates workflow to comment on the new PR

* Creates PR against devel branch

* Adds ready_for_review PR type to pull_request event

* Updates based on (Felix's) feedback

Making the comment about the draft PR on the PR's body itself.

* Update .github/workflows/ci.yaml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Adds types to pull_request_target

* Removes unused identifier from the workflow step

* Updates all missing env variables

Removes extra step, fixes typo and ANSIBLE-VERSION-MAJOR
calculation in Bash.

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

* Updates ANSIBLE_VERSION_MAJOR env variable creation

* Update .github/workflows/release-porting-guide.yml

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

* Removes id

* Update .github/workflows/release-porting-guide.yml

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

* Update .github/workflows/release-porting-guide.yml

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

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: 🇺🇦 Sviatoslav Sydorenko (Святослав Сидоренко) <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Felix Fontein <felix@fontein.de>
2025-07-14 21:46:54 +02:00
Felix Fontein
c0476092c6 Avoid all literal blocks without explicitly set language (#2807)
* Avoid code-blocks without language.

* Adjust checker to catch such code blocks as well.
2025-07-14 21:45:22 +02:00
ansible-documentation-bot[bot]
0408da36a5 ci: refresh docs build dependencies (#2806)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-14 11:26:43 +01:00
Akira Yokochi
ec23cbc62c fix option for _ANSIBLE_TEMPLAR_UNTRUSTED_TEMPLATE_BEHAVIOR (#2687) 2025-07-11 09:12:13 +01:00
Lyle McKarns
227ddc6aaf Add initial README.md for tests/ requirement files (#2577)
* Add initial README.md for tests/ requirement files

* Update tests/README.md

Update Heading, per @oraNod's suggestion

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

* Move "txt" files to colum for "in" files, update description on "constraints"

* Update tests/README.md

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

* Update tests/README.md

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

* Change Requirements to Dependencies per @webknjaz

* Applying Changes per @oraNod

* Update tests/README.md

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

* Apply suggestions from code review

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

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-07-11 09:11:26 +01:00
Jordan Borean
21a526c87d Add more Windows Kerberos delegation info (#2779)
Adds more information on testing Kerberos delegation on Windows. It
includes a klist.exe example command for showing how to retrieve a
service ticket for a specific service.
2025-07-10 15:39:52 -04:00
Matt Martz
9540ea42f5 Update 2.19 release date in support matrix (#2744) 2025-07-10 15:12:53 -04:00
Andrew Klychkov
fdcff5f8d4 community/communication.rst: improve style a bit (#2790) 2025-07-10 15:09:11 -04:00
Anwesha Das
d815334117 Merge pull request #2791 from anweshadas/release/porting-guide-12.0.0a9
Adds Porting Guide for 12.0.0a9
2025-07-10 00:07:48 +02:00
Anwesha Das
3cd7746a5b Adds Porting Guide for 12.0.0a9 2025-07-09 17:48:31 +02:00
ansible-documentation-bot[bot]
7a4701affe ci: refresh dev dependencies (#2784)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-07 09:48:46 +01:00
ansible-documentation-bot[bot]
2ee7a2ff48 ci: refresh docs build dependencies (#2787)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-07-07 09:47:42 +01:00
Felix Fontein
7cf2dedcd8 Announce Ansible 11 lifetime extension (#2491)
* [WIP] Announce Ansible 11 lifetime extension.

* Improve formulation.

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

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
2025-07-01 06:40:34 +02:00
Felix Fontein
1218d01629 Move Ansible markup documentation to a separate page (#2753)
* Move information on Ansible markup into a separate document.

* Reference documentation fields that can use Ansible markup.

* Add TOC links.

* Apply adjusted version of Don's suggestion.

* Add reference to ansible-core version.
2025-06-30 18:52:54 +01:00
ansible-documentation-bot[bot]
f370f41da0 ci: refresh dev dependencies (#2774)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-30 10:51:59 +01:00
ansible-documentation-bot[bot]
ea3eb71e67 ci: refresh docs build dependencies (#2776)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-30 10:51:21 +01:00
Andrew Klychkov
510375f072 communication.rst: improve wording (#2765)
* communication.rst: improve wording

---------

Co-authored-by: John Barker <john@johnrbarker.com>
2025-06-27 12:45:28 +01:00
Mario Lenz
3427ed4407 Update Ansible 12 porting guide for 12.0.0a7 release (#2761) 2025-06-25 20:06:05 +02:00
ansible-documentation-bot[bot]
faf3f7eac9 ci: refresh dev dependencies (#2760)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-25 07:42:56 +02:00
ansible-documentation-bot[bot]
3d4518d9ae [devel] ci: refresh docs build dependencies: bump antsibull-docs to 2.18.0 (#2756)
* Bump antsibull-docs to 2.18.0.

* ci: refresh docs build dependencies

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-24 22:17:32 +01:00
ansible-documentation-bot[bot]
f50077ef87 ci: refresh dev dependencies (#2751)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-23 15:42:36 +01:00
ansible-documentation-bot[bot]
ae75ec60f8 ci: refresh docs build dependencies (#2752)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-23 15:41:41 +01:00
ansible-documentation-bot[bot]
06716c78f1 ci: refresh docs build dependencies (#2742)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2025-06-17 22:48:15 +02:00