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


Meeting started by samccann at 16:00:03 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2022-01-18/documentation_working_group_aka_dawgs.2022-01-18-16.00.log.html
.



Meeting summary
---------------
* opening chatter  (samccann, 16:00:09)
  * ACTION: samccann to change room alert to 31 hrs for help wanted nag
    (samccann, 16:01:01)

* documentation updates  (samccann, 16:04:45)

* Community examples  (samccann, 16:07:31)
  * we're open for community base Ansible examples here -
    https://github.com/ansible-community/community-examples  (samccann,
    16:13:28)
  * LINK:
    https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey
    (samccann, 16:16:11)
  * a couple more docs survey feedback issues we could use help on -
    https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey
    (samccann, 16:16:33)
  * splitting up the community guide into getting started, core, and
    collection contributor guides -
    https://github.com/ansible/ansible/pull/76764 (WIP)  (samccann,
    16:21:48)

* generating docs for collections  (samccann, 16:22:37)
  * GitHub actions and reusable workflows you can use to generate
    documentation in your own collection repository on GitHub
    -https://github.com/ansible-community/github-docs-build  (samccann,
    16:23:50)
  * actively in use in `community.docer` and `community.hashi_vault`
    (samccann, 16:25:56)
  * LINK: https://github.com/ansible-community/github-docs-build/wiki
    (acozine, 16:34:49)
  * some early docs available at
    https://github.com/ansible-community/github-docs-build/wiki
    (samccann, 16:35:13)

* semantic markup  (samccann, 16:35:53)
  * we found out definitively that this will impact Automation Hub/
    GalaxyNG so need to coordinate with that team  (samccann, 16:37:01)
  * if anyone has additional ideas for semantic markup improvements,
    now's the time to get them in before the design goes for internal
    review with the GalaxyNG teeam!  (samccann, 16:41:10)
  * proposal - https://hackmd.io/VjN60QSoRSSeRfvGmOH1lQ  (samccann,
    16:42:04)

* Open Floor  (samccann, 16:56:32)
  * ACTION: felixfontein to write up an addition to the semantic markup
    to support seealso: for plugins as well as modules  (samccann,
    16:57:09)
  * ACTION: samcann acozine - to review
    https://github.com/ansible/ansible/issues/76609 in terms of how we
    can add to the cheatsheet and/or create split controller docs to
    help out here  (and eventual URL added to `ansible-test --help1`
    output  (samccann, 17:04:59)

Meeting ended at 17:08:05 UTC.




Action Items
------------
* samccann to change room alert to 31 hrs for help wanted nag
* felixfontein to write up an addition to the semantic markup to support
  seealso: for plugins as well as modules
* samcann acozine - to review
  https://github.com/ansible/ansible/issues/76609 in terms of how we can
  add to the cheatsheet and/or create split controller docs to help out
  here  (and eventual URL added to `ansible-test --help1` output




Action Items, by person
-----------------------
* acozine
  * samcann acozine - to review
    https://github.com/ansible/ansible/issues/76609 in terms of how we
    can add to the cheatsheet and/or create split controller docs to
    help out here  (and eventual URL added to `ansible-test --help1`
    output
* felixfontein
  * felixfontein to write up an addition to the semantic markup to
    support seealso: for plugins as well as modules
* samccann
  * samccann to change room alert to 31 hrs for help wanted nag
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (93)
* acozine (40)
* felixfontein (37)
* briantist (34)
* bcoca (15)
* zodbot (8)
* gundalow (4)
* remindbot[m] (3)




Generated by `MeetBot`_ 0.4

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