# \#dawgs-meeting **URL:** https://forum.ansible.com/tag/dawgs-meeting/376.md [Latest](https://forum.ansible.com/latest.md) · [Categories](https://forum.ansible.com/categories.md) · [Tags](https://forum.ansible.com/tags.md) --- ## [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… --- ## [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 … --- ## [Removing old backport labels in the docs repo](https://forum.ansible.com/t/removing-old-backport-labels-in-the-docs-repo/44807)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 3\ **Last updated:** [November 10, 2025, 12:16pm UTC](https://forum.ansible.com/t/removing-old-backport-labels-in-the-docs-repo/44807 "2025-11-10T12:16:19Z")
Not sure if a forum post on this is overkill or not but I’ve noticed we have a bunch of stale backport labels in the docs repo. I’d imagine it’s fine to just delete labels for old versions like, say, stable-2.14. That’l… --- ## [Moving DaWGs to async/forum discussions](https://forum.ansible.com/t/moving-dawgs-to-async-forum-discussions/44681)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 1\ **Last updated:** [October 14, 2025, 7:31pm UTC](https://forum.ansible.com/t/moving-dawgs-to-async-forum-discussions/44681 "2025-10-14T19:31:52Z")
Much as the Community Working Group decided to go to an async discussion model here on the forum, it’s time for the Documentation Working Group (aka DaWGs) to make the same transition. Why are we changing? DaWGs has al… --- ## [Where should we document the new play argspec?](https://forum.ansible.com/t/where-should-we-document-the-new-play-argspec/44588)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 1\ **Last updated:** [October 5, 2025, 2:51pm UTC](https://forum.ansible.com/t/where-should-we-document-the-new-play-argspec/44588 "2025-10-05T14:51:22Z")
So if you haven’t seen it yet, play argument specification validation is coming in ansible-core. There’s also a draft doc for this, with an open question for us - How/where should we add documentation for this? The curr… --- ## [Looking for help to revamp our sphinx ansible docs theme](https://forum.ansible.com/t/looking-for-help-to-revamp-our-sphinx-ansible-docs-theme/44609)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 0\ **Last updated:** [October 3, 2025, 4:22pm UTC](https://forum.ansible.com/t/looking-for-help-to-revamp-our-sphinx-ansible-docs-theme/44609 "2025-10-03T16:22:07Z")
So we’ve been using the sphinx\_ansible\_theme for our theme on docs.ansible.com for years now. Some other Ansible projects also use it, but it’s old/outdated, and we haven’t been keeping up on issues and so on. There’s ev… --- ## [A new look for docs.ansible.com](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 3\ **Last updated:** [September 18, 2025, 1:43pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437 "2025-09-18T13:43:51Z")
Hi everyone! I’d like to ask for the community’s feedback on changes to the layout plus look and feel of docs.ansible.com. Before we point the subdomain to Read The Docs hosting, it’s probably a better approach to set … --- ## [DaWGs Hacktoberfest 2025](https://forum.ansible.com/t/dawgs-hacktoberfest-2025/44464)
**Author:** [@Lyle\_McKarns](https://forum.ansible.com/u/Lyle_McKarns)\ **Replies:** 2\ **Last updated:** [September 16, 2025, 9:20pm UTC](https://forum.ansible.com/t/dawgs-hacktoberfest-2025/44464 "2025-09-16T21:20:26Z")
Last year there were discussions of what we could do to be more prepared to take advantage of the wider “Hacktoberfest” in 2025. One of those things was to get started preparing for it sooner, and discussing it as group… --- ## [Adding a banner to docs about templating changes in core-2.19](https://forum.ansible.com/t/adding-a-banner-to-docs-about-templating-changes-in-core-2-19/42332)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 14\ **Last updated:** [June 6, 2025, 4:24pm UTC](https://forum.ansible.com/t/adding-a-banner-to-docs-about-templating-changes-in-core-2-19/42332 "2025-06-06T16:24:38Z")
Hey folks - So I admit, the core 2.19 changes have me worried. I know we have the data-tagging tag here and loads of project discussions, but I worry we haven’t hit our users with this info. One idea that popped up was… --- ## [Documentation search engine](https://forum.ansible.com/t/documentation-search-engine/39823)
**Author:** [@hyperreal](https://forum.ansible.com/u/hyperreal)\ **Replies:** 11\ **Last updated:** [June 3, 2025, 3:40pm UTC](https://forum.ansible.com/t/documentation-search-engine/39823 "2025-06-03T15:40:30Z")
I noticed today that the Ansible Documentation search engine gives less-than-optimal results. For example, I used to search for ‘ansible.builtin.file’ and the first result would be the ansible.builtin.file module. But no… --- ## [Branching the docs for stable-2.19](https://forum.ansible.com/t/branching-the-docs-for-stable-2-19/41653)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 3\ **Last updated:** [April 15, 2025, 3:23pm UTC](https://forum.ansible.com/t/branching-the-docs-for-stable-2-19/41653 "2025-04-15T15:23:59Z")
Hey everyone, Yet another discussion thread related to stable-2.19. @samccann and I were chatting about how we should branch ansible/ansible-documentation according to the release schedule outlined in ansible-core 2.19 … --- ## [Consolidating redirects on docs.ansible.com](https://forum.ansible.com/t/consolidating-redirects-on-docs-ansible-com/38897)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 7\ **Last updated:** [February 25, 2025, 4:36pm UTC](https://forum.ansible.com/t/consolidating-redirects-on-docs-ansible-com/38897 "2025-02-25T16:36:51Z")
Hi everyone! It seems like there has been a lot of discussion about consolidating things and reducing fragmentation in the community this year. In keeping with that theme, I’ve got some plans that I want to share with y… --- ## [Should we add ibm z/OS mainframe host info to the Ansible docs?](https://forum.ansible.com/t/should-we-add-ibm-z-os-mainframe-host-info-to-the-ansible-docs/40091)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 23\ **Last updated:** [February 24, 2025, 11:26pm UTC](https://forum.ansible.com/t/should-we-add-ibm-z-os-mainframe-host-info-to-the-ansible-docs/40091 "2025-02-24T23:26:29Z")
We currently have a draft PR from the community to add some details about z/OS mainframe hosts to the Ansible (core and package) documentation, under the OS guides section. While I’ve been here …ahem… for a while, this … --- ## [Awesome Ansible list: How to make it more presentable/attractive to contribute to?](https://forum.ansible.com/t/awesome-ansible-list-how-to-make-it-more-presentable-attractive-to-contribute-to/39710)
**Author:** [@Andersson007](https://forum.ansible.com/u/Andersson007)\ **Replies:** 6\ **Last updated:** [February 18, 2025, 6:43am UTC](https://forum.ansible.com/t/awesome-ansible-list-how-to-make-it-more-presentable-attractive-to-contribute-to/39710 "2025-02-18T06:43:03Z")
Hi there, On docs.ansible.com under the Ansible ecosystem page we refer to: Ansible ecosystem page: lists key projects like ansible-core, collecitons, Navigator, AWX, etc. Awesome Ansible list: A collaborative curated… --- ## [How-to deprecate X - Documentation to be added, but where?](https://forum.ansible.com/t/how-to-deprecate-x-documentation-to-be-added-but-where/39458)
**Author:** [@russoz](https://forum.ansible.com/u/russoz)\ **Replies:** 1\ **Last updated:** [January 14, 2025, 5:10pm UTC](https://forum.ansible.com/t/how-to-deprecate-x-documentation-to-be-added-but-where/39458 "2025-01-14T17:10:48Z")
Hi everyone, Being a maintainer for community.general for a while means I have had to deal with a number of different situations. It is a lot of different things we need to remember and, honestly, I cannot keep all of t… --- ## [Should we revamp the tools and programs page?](https://forum.ansible.com/t/should-we-revamp-the-tools-and-programs-page/39024)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 9\ **Last updated:** [January 9, 2025, 7:09am UTC](https://forum.ansible.com/t/should-we-revamp-the-tools-and-programs-page/39024 "2025-01-09T07:09:05Z")
The Tools and Programs page feels dated and in conflict with Awesome Ansible. We also decided some time ago that most new tools etc should go to awesome ansible. So, I’m thinking we should trim down this Tools and Prog… --- ## [Switching search on docs to OpenSearch](https://forum.ansible.com/t/switching-search-on-docs-to-opensearch/10885)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 3\ **Last updated:** [November 18, 2024, 3:43pm UTC](https://forum.ansible.com/t/switching-search-on-docs-to-opensearch/10885 "2024-11-18T15:43:59Z")
Hi folks - We’ve had problems with our current search box solution on core and package docs. Under the covers, it’s the swiftype engine. Sphinx docs have their own built in search (open search) so we’re going back to th… --- ## [Role names in collections should be able to begin with a underscore](https://forum.ansible.com/t/role-names-in-collections-should-be-able-to-begin-with-a-underscore/10454)
**Author:** [@gardar](https://forum.ansible.com/u/gardar)\ **Replies:** 11\ **Last updated:** [October 23, 2024, 6:55pm UTC](https://forum.ansible.com/t/role-names-in-collections-should-be-able-to-begin-with-a-underscore/10454 "2024-10-23T18:55:05Z")
According to the Collection structure chapter of the docs: Role names are now limited to contain only lowercase alphanumeric characters, plus \_ and start with an alpha character. However, I’ve observed that role name… --- ## [Do we have hacktoberfest ideas for contributions?](https://forum.ansible.com/t/do-we-have-hacktoberfest-ideas-for-contributions/8397)
**Author:** [@samccann](https://forum.ansible.com/u/samccann)\ **Replies:** 0\ **Last updated:** [September 10, 2024, 1:02pm UTC](https://forum.ansible.com/t/do-we-have-hacktoberfest-ideas-for-contributions/8397 "2024-09-10T13:02:27Z")
Hacktoberfest is just around the corner so I thought we could use this thread to see if we have some good simple tasks/issues (or create some) to help people contribute to Ansible projects and collections over the month … --- ## [Failing Sphinx builds on WARN with the package docs](https://forum.ansible.com/t/failing-sphinx-builds-on-warn-with-the-package-docs/6806)
**Author:** [@oranod](https://forum.ansible.com/u/oranod)\ **Replies:** 10\ **Last updated:** [July 10, 2024, 5:44pm UTC](https://forum.ansible.com/t/failing-sphinx-builds-on-warn-with-the-package-docs/6806 "2024-07-10T17:44:33Z")
Since we’ve started building package docs in GHA the logs from each run are public and now reveal all the WARNINGs and ERRORs from RST in ansible/ansible-documentation as well as from all the modules and collections and …