Commit Graph

54060 Commits

Author SHA1 Message Date
Felix Fontein
9c0f0dba01 Fix supported Python list for 2.15. (#2968) 2025-08-07 14:01:34 -04:00
patchback[bot]
55b60b6c91 Update EOL banner for clarity (#2942) (#2943)
(cherry picked from commit 7594ea8edc)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-08-01 16:49:54 -04:00
patchback[bot]
9041b9db95 update banner to reflect this does not apply to the product (#2895) (#2937)
(cherry picked from commit 412d18f2fa)
(cherry picked from commit 8495d7da0b)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2025-08-01 15:17:42 -04:00
patchback[bot]
d86999a83e Only run pr_labeler on devel or stable-* branches (#2552) (#2602)
(cherry picked from commit a2067ce183)

Co-authored-by: Lyle McKarns <x1101@users.noreply.github.com>
2025-05-14 16:00:07 -04:00
Maxwell G
770c80a516 Merge pull request #2506 from oraNod/backport-stable-2.15
[stable-2.15] ci: use official create-github-app-token action (#2499)
2025-04-09 17:48:41 -05:00
Maxwell G
12446db01d ci: use official create-github-app-token action (#2499)
We should use the official action for retrieving the token to use for
the issue/PR triage and dependency update workflows instead of the one
we were using before.
2025-04-09 13:17:23 +01:00
Don Naro
1ce9a2f3a1 [stable 2.15] remove the relaxed reqs (#2364)
* rm relaxed reqs and base constraints

* move pins and requirements out of relaxed

* sync requirements lock file

* update noxfile to rm relaxed reqs

* update docs

* remove tagger session

* Update tests/constraints.in

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

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
2025-01-20 17:42:57 +00:00
patchback[bot]
5c074c4503 callback event reception order (#2333) (#2338)
* 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>
(cherry picked from commit 8e817dc5a0)

Co-authored-by: Brian Coca <bcoca@users.noreply.github.com>
2025-01-10 14:57:29 -05:00
patchback[bot]
d24721980d fix(style-guide): Add definition for "ID" abbreviation in spelling and word choice guide (#2332) (#2334)
- 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>
(cherry picked from commit 8e331e4b16)

Co-authored-by: Ganesh Hubale <ganeshhubale03@gmail.com>
2025-01-10 14:56:10 -05:00
Don Naro
0ea8d835ea fixes #2177 for stable-2.15 (#2264) 2024-12-10 10:34:17 -05:00
ansible-documentation-bot[bot]
f205ef2dc4 ci: refresh dev dependencies (#2229)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-12-02 12:40:41 +00:00
ansible-documentation-bot[bot]
59b94c21c9 ci: refresh dev dependencies (#2223)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-11-25 18:18:29 +00:00
Don Naro
692b918482 LICENSE and DCO in CODEOWNERS (#2208)
This change adds the LICENSE and DCO files to CODEOWNERS and
specifies the community docs maintainers team as owners.
The purpose of this change is to prevent any unintentional or
unauthorized modifications to these files. Resolves #2178
2024-11-20 15:01:11 -05:00
patchback[bot]
074743bb4c add note and link for galaxy.yml details (#2092) (#2115)
(cherry picked from commit 8c244c3e0b)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-11-18 13:52:46 -05:00
patchback[bot]
3c64101d55 update release table with 2.15 EOL (#2184) (#2186)
(cherry picked from commit fd2c82a8a2)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-11-18 13:43:31 -05:00
Sandra McCann
4eacc43950 Add EOL banner to 2.15 docs (#2185) 2024-11-18 12:38:49 -05:00
patchback[bot]
76022ab613 Update some info on distribution servers (#2119) (#2179)
* update some links

* remove galax details and leave it to galaxy docs

(cherry picked from commit 7f11306526)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-11-18 10:57:13 -05:00
patchback[bot]
2194bf3bc2 fix: Remove stray reference to group_by_module (#2142) (#2143)
Reference to group_by_module was substituted in where it did not make
sense:  https://github.com/ansible/ansible/pull/43856

This reference is not essential.  It is already referenced
indirectly, via :ref:`os_variance`.

Revert back to referencing the variables page.

Credit for fix and diagnosis: @samccann.  See issue #2077.

(cherry picked from commit 4f0f5d1cf2)

Co-authored-by: Alan Jenkins <alan.christopher.jenkins@gmail.com>
2024-11-18 10:49:24 -05:00
patchback[bot]
673ff2fa77 remove swiftype search engine (#2140) (#2149)
(cherry picked from commit e427a22bb4)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-11-18 10:46:47 -05:00
ansible-documentation-bot[bot]
c8be7c1057 ci: refresh dev dependencies (#2172)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-11-18 11:39:48 +00:00
ansible-documentation-bot[bot]
6438f4c47f ci: refresh dev dependencies (#2122)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-11-12 13:49:06 +00:00
ansible-documentation-bot[bot]
3305b4ead4 ci: refresh dev dependencies (#2083) 2024-11-05 20:35:26 -06:00
patchback[bot]
c82b5a227e nox pip-compile: temporarily pin pip version (#2085) (#2110)
Relates: https://github.com/ansible/ansible-documentation/pull/1950#issuecomment-2443949725
Relates: https://github.com/jazzband/pip-tools/issues/2131
(cherry picked from commit ef750f6dcf)

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2024-11-05 18:29:43 -06:00
patchback[bot]
0d52505d23 fix: correct typos (#2062) (#2068)
(cherry picked from commit a66233489a)

Co-authored-by: Hsiang-Jen Li <71996166+hsiangjenli@users.noreply.github.com>
v2.15.13 v2.15.13rc1
2024-10-29 14:16:53 -04:00
patchback[bot]
520c644593 Add details of interactions between notifications and loops (#597) (#2063)
* Add details of interactions between notifications and loops

This clarifies behaviour raised in https://github.com/ansible/ansible/issues/81950 and https://github.com/ansible/ansible/issues/77550 as expected and documented.

* Apply suggestions from code review

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

* Incorporate suggestions from @felixfontein

Make the loop trigger even more explicit.

---------

Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Maxwell G <maxwell@gtmx.me>
(cherry picked from commit 74b2c95dd4)

Co-authored-by: David Tulloh <github-david@tulloh.id.au>
2024-10-25 11:12:11 +01:00
patchback[bot]
4f2c45b080 Remove ansible-test sanity from local module development (#2034) (#2056)
* Remove ansible-test sanity from local module development

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

(cherry picked from commit ef72400cc2)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-10-24 15:35:31 -04:00
patchback[bot]
f19aeb4f2b add example of extending ansible_facts (#2040) (#2059)
* add example of extending ansible_facts

* Apply suggestions from code review

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

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
(cherry picked from commit d693f43ba7)

Co-authored-by: Sandra McCann <samccann@redhat.com>
2024-10-24 15:34:24 -04:00
Don Naro
ececb7efa7 Bump wntrblm/nox from 2024.04.15 to 2024.10.09 (#2006) (#2044)
Bumps [wntrblm/nox](https://github.com/wntrblm/nox) from 2024.04.15 to 2024.10.09.
- [Release notes](https://github.com/wntrblm/nox/releases)
- [Changelog](https://github.com/wntrblm/nox/blob/main/CHANGELOG.md)
- [Commits](https://github.com/wntrblm/nox/compare/2024.04.15...2024.10.09)

---
updated-dependencies:
- dependency-name: wntrblm/nox
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
(cherry picked from commit e80f481e51)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-10-23 10:26:09 +01:00
patchback[bot]
4dce7ba43c use standard indentation (#2005) (#2025)
(cherry picked from commit ac793d208d)

Co-authored-by: Douglas Griffith <dwg@grth.ca>
2024-10-16 12:41:35 +01:00
patchback[bot]
c8df49ef14 Add ecosystem_project_resources.rst document (#2007) (#2008)
* Add ecosystem_project_resources.rst document

* Fix rst

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
(cherry picked from commit c41abec27c)

Co-authored-by: Andrew Klychkov <aklychko@redhat.com>
2024-10-15 19:10:10 +01:00
Maxwell G
58b4b356e4 nox pip-compile: support check mode (#1949)
Support a custom --check flag to fail if pip-compile made any changes so
we can check that that lockfiles are in sync with the input (.in) files.

(cherry picked from commit cb295b1f78)
2024-10-15 19:08:45 +01:00
patchback[bot]
87b221959a Update playbooks_error_handling.rst (#1982) (#1983)
Closes #1895.

Correct example so it behaves as described in the docs. The message "No such file or directory" is sent to stderr, not to stdout.

(cherry picked from commit 7063491dc8)

Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
2024-10-08 15:00:55 -04:00
patchback[bot]
ccb4cae20c Moved when condition after task name for block example (#1961) (#1966)
when condition should come after name in blocks
See: https://ansible.readthedocs.io/projects/lint/rules/key-order/

(cherry picked from commit e6f2cc9ffc)

Co-authored-by: dancorrigan1 <dancorrigan1@gmail.com>
2024-10-02 20:17:55 +01:00
patchback[bot]
aac908b419 Update introduction.rst (#1960) (#1962)
(cherry picked from commit ecbda9b98c)

Co-authored-by: quicktus <quintuswenker@gmail.com>
2024-10-02 20:16:41 +01:00
Maxwell G
3ca918722b [stable-2.15] Backport pr_labeler changes (#1917)
* pr_labeler: improve create_boilerplate_comment logging

(cherry picked from commit 5730ba9a01)

* pr_labeler: add --force-process-closed flag

(cherry picked from commit 44ffe0f210)

* pr_labeler: add warning for porting_guides changes

This adds a warning message when PRs are created that edit
porting_guides by someone outside of the Release Management WG. These
files are automatically generated during the ansible release process and
should not be modified.

Fixes: https://github.com/ansible/ansible-documentation/issues/503
(cherry picked from commit d2e6625e8b)

* pr_labeler: use @release-management-wg team for porting_guide check

Instead of hardcoding the list of release managers, we can use the
Github API to retrieve the members of the
`@ansible/release-management-wg` team.

(cherry picked from commit dddfd7eb55)

* pr_labeler: exempt bots from porting_guide check

For example, patchback is not a release manager, but we still want it to
backport Porting Guide PRs.

(cherry picked from commit 746662c255)

* pr_labeler: improve porting_guide_changes template wording

Co-authored-by: Sandra McCann <samccann@redhat.com>
(cherry picked from commit 95ece7e9d6)

* pr_labeler: refactor new_contributor_welcome code (#990)

* pr_labeler: add GlobalArgs.full_repo property

* pr_labeler: refactor new_contributor_welcome code

As of https://github.com/ansible/ansible-documentation/issues/69, the
pr_labeler responds with a welcome message when an issue or PR is opened
by a new contributor. It turns out this never actually worked properly.

The previous method that relied on Github's `author_association` flag
did not work with the app token that the pr_labeler uses. This refactors
the code to figure out whether a user is a new contributor by
searching the list of issues and PRs.

Fixes: https://github.com/ansible/ansible-documentation/issues/204

* pr_labeler: address potential race condition

(cherry picked from commit 763815d1ad)

* Bump actions/setup-python from 4 to 5 (#966)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

(cherry picked from commit 466b1fdc43)

* pr_labeler: re-architect triager script (#1882)

This commit reorganizes the issue/PR triager script and updates the
workflow to run more efficiently.

- Make the script a proper Python package instead of an unwieldy single
  file
- Use locked dependencies and UV to decrease workflow runtime to under
  10 seconds.

(cherry picked from commit 7138e42716)
(cherry picked from commit 1cf9f7917b)

---------

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-09-20 10:49:02 +01:00
Maxwell G
3095c933c1 ci: avoid interpolating inputs into run: scripts (#740) (#1913)
Github Actions makes it easy to inject arbitrary shell code into Github
Actions scripts thanks to the way its templating language works.
This change mediates that issue by passing action inputs to the `run:`
scripts as env vars instead of using `${{ }}` expansions directly in the
script bodies.

The pr_labeler job is the only one that both runs on pull requests and
has access to secrets, but we don't interpolate anything other than
`github.event.number`, so that wouldn't allow any malicious person to
steal credentials.
reusable-pip-compile has access to secrets and accepts user input, but
only from trusted sources (i.e., developers who already have write
access to this repository) and can manually trigger workflows.
Still, it's a good to tighten this up.

(cherry picked from commit 5ebf9f1686)
2024-09-18 11:48:01 +01:00
patchback[bot]
84c1f34ef1 Add caveat about installing collections from git (#1894) (#1896)
(cherry picked from commit d97cc2745c)

Co-authored-by: Matt Martz <matt@sivel.net>
2024-09-17 09:19:55 +01:00
ansible-documentation-bot[bot]
672bc993b7 ci: refresh dev dependencies (#1887) 2024-09-14 23:18:30 -05:00
Andrew Klychkov
edd827b4c3 Replace communication links with a link to communication guide, part 2 (#1864) (#1876)
* Replace old communication refs with Communication guide ref or forum

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

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

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
(cherry picked from commit bf86a30bef)
2024-09-12 10:00:33 +01:00
patchback[bot]
2fe595a8c5 Replace communication links with a link to communication guide, part 1 (#1851) (#1860)
* Replace communication links with a link to communication guide

* Update docs/docsite/rst/command_guide/intro_adhoc.rst

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

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

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

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

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

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

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

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

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

* fix

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
(cherry picked from commit ae59246f0b)

Co-authored-by: Andrew Klychkov <aklychko@redhat.com>
2024-09-11 10:31:57 +01:00
ansible-documentation-bot[bot]
011250409a ci: refresh dev dependencies (#1841)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-09-09 23:44:37 +02:00
patchback[bot]
71c9393433 community_steering_committee.rst: fix collection requirements link (#1828) (#1838)
(cherry picked from commit 81bcc2fccd)

Co-authored-by: Andrew Klychkov <aklychko@redhat.com>
2024-09-09 15:36:51 +02:00
ansible-documentation-bot[bot]
16ad3c6eb6 ci: refresh dev dependencies (#1830) 2024-09-08 14:13:04 -05:00
ansible-documentation-bot[bot]
aaa3498718 ci: refresh dev dependencies (#1825)
Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-09-02 16:38:23 +01:00
Andrew Klychkov
7cfc4a72d6 steering_committee_membership: clarify guidelines about team representatives (#1806) (#1819)
Based on general discussions we've been having over the past year about
inactive steering committee members, I figured we should clarify the
team representative section that we recently added (for Core and
potentially other teams in the future).

(cherry picked from commit 5adb400dc2)

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2024-08-29 14:55:08 -04:00
patchback[bot]
25ad4a78cd nox: support nox uv backend (#1757) (#1807)
Nox now has a separate venv backend that uses the Rust-based pip
replacement, uv. Let's add support for this to our install function so
that the constraints are respected when using the uv backend.

(cherry picked from commit a74da7db41)

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2024-08-26 17:27:51 +01:00
ansible-documentation-bot[bot]
109b8072be [stable-2.15] ci: refresh dev dependencies (#1796)
* ci: refresh dev dependencies

* ci: refresh dev dependencies

---------

Co-authored-by: Ansible Documentation Bot <147556122+ansible-documentation-bot[bot]@users.noreply.github.com>
2024-08-26 11:21:51 +01:00
Maxwell G
51a8972c5a [stable-2.15] tests: update dependencies for compatibility with new Pythons (#1790)
* tests: update pydantic version in lockfile

Fixes compatibility with newer versions of Python 3.12.

Closes: https://github.com/ansible/ansible-documentation/issues/1784

* tests: update aio-libs packages for compatibility with new Pythons
2024-08-26 11:06:41 +01:00
Don Naro
3787bcc5a6 ci: ensure ansible-core files exist before running docs build (#1756) (#1782)
Also, make KEEP_DIRS and KEEP_FILES constants to make the main function
cleaner.

Fixes: https://github.com/ansible/ansible-documentation/issues/1056
(cherry picked from commit 0d35022030)

Co-authored-by: Maxwell G <maxwell@gtmx.me>
2024-08-22 09:07:33 +01:00
patchback[bot]
9552ce6162 fix indents network documents (#1776) (#1777)
(cherry picked from commit 6f8f25f7d1)

Co-authored-by: Akira Yokochi <akira6592@gmail.com>
2024-08-21 17:06:42 +01:00