# \#documentation **URL:** https://forum.ansible.com/tag/documentation/7.md [Latest](https://forum.ansible.com/latest.md) · [Categories](https://forum.ansible.com/categories.md) · [Tags](https://forum.ansible.com/tags.md) --- ## [Proposal: document role "return variables" in argument\_specs.yml (like module RETURN)](https://forum.ansible.com/t/proposal-document-role-return-variables-in-argument-specs-yml-like-module-return/46469)
**Author:** [@spetrosi](https://forum.ansible.com/u/spetrosi)\ **Replies:** 22\ **Last updated:** [October 16, 2026, 4:35pm UTC](https://forum.ansible.com/t/proposal-document-role-return-variables-in-argument-specs-yml-like-module-return/46469 "2026-10-16T16:35:33Z")
Hello everyone, I’d like to propose way for roles to document the variables they set, rendered as a table on the role’s documentation page the same way modules document their return values today. I initiated this in an… --- ## [Execution Environment from docs doesn't install Python in container](https://forum.ansible.com/t/execution-environment-from-docs-doesnt-install-python-in-container/46272)
**Author:** [@EmersonPrado](https://forum.ansible.com/u/EmersonPrado)\ **Replies:** 12\ **Last updated:** [September 14, 2026, 6:27pm UTC](https://forum.ansible.com/t/execution-environment-from-docs-doesnt-install-python-in-container/46272 "2026-09-14T18:27:55Z")
Hi all! I tried to set up an Execution Environment following the official articles Setting up your environment and Building your first Execution Environment, but the builder command fails (not all lines shown): ansible… --- ## [Removing the sphinx constraint on devel](https://forum.ansible.com/t/removing-the-sphinx-constraint-on-devel/46130)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 5\ **Last updated:** [September 11, 2026, 4:02pm UTC](https://forum.ansible.com/t/removing-the-sphinx-constraint-on-devel/46130 "2026-09-11T16:02:39Z")
Hi all, We recently bumped the sphinx version on the devel branch of ansible/ansible-documentation. This is pinned in the constraints.in file here: ansible-documentation/tests/constraints.in at bb7e06f49d81b02e42f32efba… --- ## [\[Vote ended on 2026-07-28\] Ansible 15 roadmap](https://forum.ansible.com/t/vote-ended-on-2026-07-28-ansible-15-roadmap/45989)
**Author:** [@mariolenz](https://forum.ansible.com/u/mariolenz)\ **Replies:** 6\ **Last updated:** [July 31, 2026, 2:01am UTC](https://forum.ansible.com/t/vote-ended-on-2026-07-28-ansible-15-roadmap/45989 "2026-07-31T02:01:55Z")
I’ve created a draft for a possible Ansible 15 roadmap. I’m not sure when we should start a vote on this. Maybe we should wait one or two weeks to give people enough time to review. --- ## [Cloudflare prevents me from using docs.ansible.com sometimes](https://forum.ansible.com/t/cloudflare-prevents-me-from-using-docs-ansible-com-sometimes/46052)
**Author:** [@ChristianStadelmann](https://forum.ansible.com/u/ChristianStadelmann)\ **Replies:** 14\ **Last updated:** [July 18, 2026, 6:49pm UTC](https://forum.ansible.com/t/cloudflare-prevents-me-from-using-docs-ansible-com-sometimes/46052 "2026-07-18T18:49:52Z")
I’m often using the Ansible Community Documentation on https://docs.ansible.com/. This page seems to be using cloudflare to protect against overloading the website, which I can understand, especially due to people lettin… --- ## [\[RESOLVED\] Ansible Community AI Policy Proposal](https://forum.ansible.com/t/resolved-ansible-community-ai-policy-proposal/45655)
**Author:** [@Andersson007](https://forum.ansible.com/u/Andersson007)\ **Replies:** 5\ **Last updated:** [April 28, 2026, 6:19am UTC](https://forum.ansible.com/t/resolved-ansible-community-ai-policy-proposal/45655 "2026-04-28T06:19:48Z")
Hello, Community! During the Ansible Contributor Summit at CfgMgmtCamp and in a forum post, we discussed a lack of AI policy in Ansible and concluded that it should be developed, discussed, and accepted Ansible-wide ASA… --- ## [Clarification on breaking changes in changelogs](https://forum.ansible.com/t/clarification-on-breaking-changes-in-changelogs/45711)
**Author:** [@mariolenz](https://forum.ansible.com/u/mariolenz)\ **Replies:** 10\ **Last updated:** [April 25, 2026, 5:38pm UTC](https://forum.ansible.com/t/clarification-on-breaking-changes-in-changelogs/45711 "2026-04-25T17:38:22Z")
I have a question on breaking changes and their documentation in the changelog. As a reminder, creating a changelog fragment states that breaking changes MUST include changes that break existing playbooks or roles. Thi… --- ## [Galaxy\_ng: links to open an issue in README and project's docsite don't work](https://forum.ansible.com/t/galaxy-ng-links-to-open-an-issue-in-readme-and-projects-docsite-dont-work/45698)
**Author:** [@Andersson007](https://forum.ansible.com/u/Andersson007)\ **Replies:** 1\ **Last updated:** [April 17, 2026, 8:32am UTC](https://forum.ansible.com/t/galaxy-ng-links-to-open-an-issue-in-readme-and-projects-docsite-dont-work/45698 "2026-04-17T08:32:29Z")
Hello, GalaxyNG team Links to open an issue don’t work on the following pages: README docsite Needs to be urgently updated as users can’t file any issue at the moment. --- ## [Documentation Attributes for PowerShell versions](https://forum.ansible.com/t/documentation-attributes-for-powershell-versions/45649)
**Author:** [@jborean](https://forum.ansible.com/u/jborean)\ **Replies:** 7\ **Last updated:** [April 8, 2026, 8:41pm UTC](https://forum.ansible.com/t/documentation-attributes-for-powershell-versions/45649 "2026-04-08T20:41:04Z")
Hi I’m trying to work through the process on how best to document the versions of PowerShell that a module may support. In the past modules only worked on Windows PowerShell provided by Windows. The upcoming Ansible 2.2… --- ## [incomplete filter docs](https://forum.ansible.com/t/incomplete-filter-docs/45624)
**Author:** [@nickhardiman](https://forum.ansible.com/u/nickhardiman)\ **Replies:** 5\ **Last updated:** [April 2, 2026, 4:58pm UTC](https://forum.ansible.com/t/incomplete-filter-docs/45624 "2026-04-02T16:58:11Z")
some doc pages on filters are incomplete. Where’s the best place to start with discussing filter docs? I was looking at filter docs today. This filter page looks great. ansible.utils.ipaddr filter – This filter is de… --- ## [Tagging Ansible documentation for 2.16](https://forum.ansible.com/t/tagging-ansible-documentation-for-2-16/45267)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 20\ **Last updated:** [March 1, 2026, 2:55pm UTC](https://forum.ansible.com/t/tagging-ansible-documentation-for-2-16/45267 "2026-03-01T14:55:59Z")
Hi everyone, The ansible-core project is still releasing 2.16 versions for downstream purposes even though 2.16 is EOL upstream. I removed 2.16 from the tagger script in the ansible/ansible-documentation repo back in No… --- ## [CfgMgmtCamp 2026 discussion (6/12): Collection documentation on Ansible Galaxy is incomplete and partially confusing](https://forum.ansible.com/t/cfgmgmtcamp-2026-discussion-6-12-collection-documentation-on-ansible-galaxy-is-incomplete-and-partially-confusing/45293)
**Author:** [@felixfontein](https://forum.ansible.com/u/felixfontein)\ **Replies:** 5\ **Last updated:** [February 19, 2026, 5:13pm UTC](https://forum.ansible.com/t/cfgmgmtcamp-2026-discussion-6-12-collection-documentation-on-ansible-galaxy-is-incomplete-and-partially-confusing/45293 "2026-02-19T17:13:19Z")
As a user Collection documentation on Ansible Galaxy is incomplete and partially confusing Latest developments None that I know of. This wasn’t discussed at CfgMgmtCamp 2026. Original text There are some things about A… --- ## [CfgMgmtCamp 2026 discussion (11/12): Features are removed without public discussion or known good reason](https://forum.ansible.com/t/cfgmgmtcamp-2026-discussion-11-12-features-are-removed-without-public-discussion-or-known-good-reason/45298)
**Author:** [@felixfontein](https://forum.ansible.com/u/felixfontein)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 5:51pm UTC](https://forum.ansible.com/t/cfgmgmtcamp-2026-discussion-11-12-features-are-removed-without-public-discussion-or-known-good-reason/45298 "2026-02-09T17:51:38Z")
As a collection developer/maintainer Features are removed without public discussion or known good reason Latest developments None that I know of. This wasn’t discussed at CfgMgmtCamp 2026. Original text This one is ver… --- ## [AWX modernization: Exploring the OpenAPI specification in AWX community documentation](https://forum.ansible.com/t/awx-modernization-exploring-the-openapi-specification-in-awx-community-documentation/45198)
**Author:** [@tvo318](https://forum.ansible.com/u/tvo318)\ **Replies:** 5\ **Last updated:** [January 28, 2026, 9:57am UTC](https://forum.ansible.com/t/awx-modernization-exploring-the-openapi-specification-in-awx-community-documentation/45198 "2026-01-28T09:57:21Z")
Hi everyone, I want to follow up on the previous post about the AWX modernization effort with some progress on the developer documentation front. We’ve just merged pull request (PR) #16221 to render the OpenAPI specifi… --- ## [Roadmap and breaking changes](https://forum.ansible.com/t/roadmap-and-breaking-changes/45127)
**Author:** [@juju4](https://forum.ansible.com/u/juju4)\ **Replies:** 4\ **Last updated:** [January 25, 2026, 8:21pm UTC](https://forum.ansible.com/t/roadmap-and-breaking-changes/45127 "2026-01-25T20:21:49Z")
Hello, New to forum and looking for ansible roadmap, more future ansible 14 as 13 just got out. I saw \[Vote ended on 2025-09-18\] Ansible 13 roadmap - #9 by felixfontein (Ansible 13 roadmap by mariolenz · Pull Request #… --- ## [Outdated docs on collections](https://forum.ansible.com/t/outdated-docs-on-collections/45086)
**Author:** [@mirabilos](https://forum.ansible.com/u/mirabilos)\ **Replies:** 6\ **Last updated:** [January 19, 2026, 11:16am UTC](https://forum.ansible.com/t/outdated-docs-on-collections/45086 "2026-01-19T11:16:53Z")
The docs say things like to have at least an empty \_\_init\_\_.py, but the stock collections like community.general don’t have one. Instead, they have lots of complex files (JSON in toplevel, YAML and text in meta/, …). Ar… --- ## [Return documentation fragments, the way forward](https://forum.ansible.com/t/return-documentation-fragments-the-way-forward/44422)
**Author:** [@bcoca](https://forum.ansible.com/u/bcoca)\ **Replies:** 19\ **Last updated:** [December 15, 2025, 5:48pm UTC](https://forum.ansible.com/t/return-documentation-fragments-the-way-forward/44422 "2025-12-15T17:48:45Z")
For ansible-core 2.20 we added the ability for modules to use ‘fragments’ to document ‘return’ documentation, something we’ve been able to do for a long time for ‘options’. add fragments to return by bcoca · Pull Request… --- ## [\[Vote ended on 2025-11-27\] Ansible 14 roadmap](https://forum.ansible.com/t/vote-ended-on-2025-11-27-ansible-14-roadmap/44778)
**Author:** [@mariolenz](https://forum.ansible.com/u/mariolenz)\ **Replies:** 6\ **Last updated:** [November 27, 2025, 3:52pm UTC](https://forum.ansible.com/t/vote-ended-on-2025-11-27-ansible-14-roadmap/44778 "2025-11-27T15:52:20Z")
I’ve created a draft for a possible Ansible 14 roadmap. I’m not sure when we should start a vote on this. Maybe we should wait until 13.0.0 is released. Anyway, maybe you could already have a look at it if it’s basicall… --- ## [The Bullhorn, #209](https://forum.ansible.com/t/the-bullhorn-209/44851)
**Author:** [@anwesha](https://forum.ansible.com/u/anwesha)\ **Replies:** 0\ **Last updated:** [November 17, 2025, 4:35pm UTC](https://forum.ansible.com/t/the-bullhorn-209/44851 "2025-11-17T16:35:04Z")
This week in Ansible Community Issue #209, 2025-11-17 (Past Issues) Welcome to The Bullhorn, our newsletter for the Ansible Community. If you have any questions or content you’d like to share, you’re welcome to ch… --- ## [We’re moving to Read The Docs](https://forum.ansible.com/t/we-re-moving-to-read-the-docs/43519)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 21\ **Last updated:** [November 10, 2025, 2:42pm UTC](https://forum.ansible.com/t/we-re-moving-to-read-the-docs/43519 "2025-11-10T14:42:03Z")
Hi everyone! The Ansible community team at Red Hat is excited to announce that we plan to migrate the docs.ansible.com subdomain to Read The Docs hosting. This post explains our motivation and outlines our plan. Before … --- ## [Meeting Log | Ansible Docs | 2025-10-21 15:02:30](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-21-1530/44720)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [October 21, 2025, 3:42pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-21-1530/44720 "2025-10-21T15:42:12Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-10-21 15:02:30 Meeting summary TOPIC: Ending the weekly mat… --- ## [Meeting Log | Ansible Docs | 2025-10-14 15:02:31](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-14-1531/44680)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [October 14, 2025, 3:34pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-14-1531/44680 "2025-10-14T15:34:24Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-10-14 15:02:31 Meeting summary TOPIC: documenting play args… --- ## [Meeting Log | Ansible Docs | 2025-10-07 15:03:04](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-07-1504/44627)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [October 7, 2025, 4:01pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-10-07-1504/44627 "2025-10-07T16:01:57Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @orandon:ansible.im at 2025-10-07 15:03:04 Meeting summary TOPIC: documenting the new pl… --- ## [Meeting Log | Ansible Docs | 2025-09-30 15:01:03](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-30-1503/44587)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [September 30, 2025, 3:53pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-30-1503/44587 "2025-09-30T15:53:35Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-09-30 15:01:03 Meeting summary INFO: new look and feel to the d… --- ## [Getting a weird error with install](https://forum.ansible.com/t/getting-a-weird-error-with-install/39381)
**Author:** [@rockyjeff](https://forum.ansible.com/u/rockyjeff)\ **Replies:** 2\ **Last updated:** [September 30, 2025, 12:45pm UTC](https://forum.ansible.com/t/getting-a-weird-error-with-install/39381 "2025-09-30T12:45:46Z")
Hi All, I’m encountering an issue while trying to install AWX using Docker Compose. It seems to fail during the build process, and I’m not sure how to resolve it. Here are the details of the error: 10.13 CentOS Stream… --- ## [Meeting Log | Ansible Docs | 2025-09-23 15:01:21](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-23-1521/44539)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [September 23, 2025, 4:02pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-23-1521/44539 "2025-09-23T16:02:15Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-09-23 15:01:21 Meeting summary INFO: will update docs.ansible.c… --- ## [\[Vote ended on 2025-09-18\] Ansible 13 roadmap](https://forum.ansible.com/t/vote-ended-on-2025-09-18-ansible-13-roadmap/44367)
**Author:** [@mariolenz](https://forum.ansible.com/u/mariolenz)\ **Replies:** 10\ **Last updated:** [September 18, 2025, 2:47pm UTC](https://forum.ansible.com/t/vote-ended-on-2025-09-18-ansible-13-roadmap/44367 "2025-09-18T14:47:04Z")
I’ve created a draft for a possible Ansible 13 roadmap. @SteeringCommittee Please have a look at it. I’m not sure when we should start a vote on this. Maybe we should wait until 12.0.0rc1 is released, or even 12.0.0. --- ## [Meeting Log | Ansible Docs | 2025-09-09 15:02:07](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-09-1507/44449)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [September 9, 2025, 3:53pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-09-1507/44449 "2025-09-09T15:53:20Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-09-09 15:02:07 Meeting summary TOPIC: new look for docs.ans… --- ## [Meeting Log | Ansible Docs | 2025-09-02 15:07:30](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-02-1530/44404)
**Author:** [@MeetingBot](https://forum.ansible.com/u/MeetingBot)\ **Replies:** 0\ **Last updated:** [September 2, 2025, 4:05pm UTC](https://forum.ansible.com/t/meeting-log-ansible-docs-2025-09-02-1530/44404 "2025-09-02T16:05:43Z")
DaWGs aka Documentation Working Group | Ansible Docs | #docs:ansible.com Meeting started by @samccann:ansible.im at 2025-09-02 15:07:30 Meeting summary TOPIC: Triage (@samccann:ans… --- ## [Documenting roles](https://forum.ansible.com/t/documenting-roles/42700)
**Author:** [@andy-maier](https://forum.ansible.com/u/andy-maier)\ **Replies:** 5\ **Last updated:** [August 9, 2025, 9:47am UTC](https://forum.ansible.com/t/documenting-roles/42700 "2025-08-09T09:47:12Z")
I am trying to document our Ansible roles and to generate .md or .rst files from them. The Ansible docs recommend documenting roles in meta/argument\_specs.yml, but they are silent about how an .md or .rst file can be ge… [Next page](https://forum.ansible.com/tag/documentation/7.md?match_all_tags=true&page=1&tags%5B%5D=documentation)