#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. Opening Chatter (samccann, 16:08:22)
   
2. Action Item Review (samccann, 16:13:42)
   1. https://github.com/ansible/community/issues/579#issuecomment-964347798 (samccann, 16:13:58)
   2. working on getting us to Sphinx 4.2 and updated requirements in general. Will sync with test updates coming from core soon and then be ready to merge (samccann, 16:14:57)
   
   
3. Docs survey feedback (samccann, 16:17:19)
   1. making strides on the survey issues. Module docs should be showing first in the list of plugins soon. (samccann, 16:17:56)
   2. acozine added a list of places where we use `host: all` so we can move forward on https://github.com/ansible/ansible/issues/75506 (samccann, 16:19:03)
   3. looking for volunteers to tackle some of the other survey issues that folks felt we needed to fix - https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey (samccann, 16:19:36)
   
   
4. Semantic Markup (samccann, 16:20:38)
   1. created a proposal for semantic markup https://github.com/ansible-community/community-topics/issues/53 so we can solicit comments/feedback (samccann, 16:21:47)
   2. confirmed that this detail will be present in the `ansible-doc --json` output that many other projects use (galaxy-ng, ansible-navigator, AH, collection_prep script, possibly vscode plugin so we need to coordinate the change (samccann, 16:22:53)
   
   
5. Community-contributed examples (samccann, 16:27:44)
   1. reviving this discussion https://github.com/ansible-community/community-topics/issues/39 (samccann, 16:27:58)
   2. Docs survey respondents asked for more examples in ansible. The idea is to create a repo with CI to accept and test community-contributed examples. We may link to them from docs.ansible.com or bring them into the docs themselves at some point (samccann, 16:29:03)
   3. AGREED: e will create the examples repo in ansible-community and call it community-examples (samccann, 16:47:37)
   
   
6. Ansible 5 prep (samccann, 16:47:56)
   1. we will remove Ansible 4 from the version switcher when Ansible 5 releases (samccann, 16:53:58)
   
   
7. Open Floor (samccann, 16:54:31)
   1. if you are having problems building docs locally for Ansible (make webdocs) experiment with ~/.antsibull.cfg, specifically something like thread_max = 3 and max_retries = 15. (samccann, 17:06:17)

Action items

1. (none)

People present (lines said)

1. samccann (98)
2. gwmngilfen-work (47)
3. felixfontein (41)
4. acozine (41)
5. zodbot (12)
6. briantist (11)
7. dmsimard (11)
8. bcoca (11)
9. ariordan (9)
10. remindbot[m] (3)
11. Gwmngilfen (0)