====================================================
#ansible-docs: Documentation Working Group aka DaWGs
====================================================


Meeting started by samccann at 16:08:02 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-11-16/documentation_working_group_aka_dawgs.2021-11-16-16.08.log.html
.



Meeting summary
---------------
* Opening Chatter  (samccann, 16:08:22)

* Action Item Review  (samccann, 16:13:42)
  * LINK:
    https://github.com/ansible/community/issues/579#issuecomment-964347798
    (samccann, 16:13:58)
  * 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)

* Docs survey feedback  (samccann, 16:17:19)
  * making strides on the survey issues. Module docs should be showing
    first in the list of plugins soon.  (samccann, 16:17:56)
  * 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)
  * 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)

* Semantic Markup  (samccann, 16:20:38)
  * 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)
  * 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)

* Community-contributed examples  (samccann, 16:27:44)
  * reviving this discussion
    https://github.com/ansible-community/community-topics/issues/39
    (samccann, 16:27:58)
  * 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)
  * AGREED: e will create the examples repo in ansible-community and
    call it community-examples  (samccann, 16:47:37)

* Ansible 5 prep  (samccann, 16:47:56)
  * we will remove Ansible 4 from the version switcher when Ansible 5
    releases  (samccann, 16:53:58)

* Open Floor  (samccann, 16:54:31)
  * 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)

Meeting ended at 17:20:56 UTC.




Action Items
------------





Action Items, by person
-----------------------
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (98)
* gwmngilfen-work (47)
* felixfontein (41)
* acozine (41)
* zodbot (12)
* briantist (11)
* dmsimard (11)
* bcoca (11)
* ariordan (9)
* remindbot[m] (3)
* Gwmngilfen (0)




Generated by `MeetBot`_ 0.3

.. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions