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


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



Meeting summary
---------------
* opening chatter  (samccann, 16:00:17)

* Community guide docs  (samccann, 16:04:32)
  * starting a project to combine community docs from ansible/ansible
    and other repos where it exists.
    https://hackmd.io/3Cvy2N8tTfSrUzqYZmfEHA  (samccann, 16:04:44)
  * step 1 - combine the info  (samccann, 16:06:11)
  * step 2 - publish (possibly from different repos)  (samccann,
    16:06:23)
  * ACTION: @samccann to turn community docs idea into a community-topic
    proposal and share on bullorn and reddit   (samccann, 16:24:36)

* Better changelog guidelines  (samccann, 16:26:03)
  * We had some feedback to create better guidance for developers on
    what to include in changelog fragments -
    https://hackmd.io/ZdymdeUSQNeM0hMjsn7vig  (samccann, 16:26:29)
  * some ansible-core changelogs impact other developers. Most/all
    collection changelogs impact end users  (samccann, 16:34:40)
  * ACTION: @samccann to turn changelog guidance into community-topic to
    widen discussion/feedback  (samccann, 16:45:06)

* DocTools  (samccann, 16:45:27)
  * simplified module tables are up on devel!
    https://docs.ansible.com/ansible/devel/collections/community/general/aix_lvol_module.html
    (samccann, 16:45:43)
  * good samples of this
    https://docs.ansible.com/ansible/devel/collections/community/crypto/acme_certificate_module.html#parameters
    and
    https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/hashi_vault_lookup.html#parameters
    and
    https://docs.ansible.com/ansible/devel/collections/cisco/ios/ios_bgp_address_family_module.html#parameters
    (samccann, 16:52:26)

* Open Floor  (samccann, 16:53:33)
  * The docs build github stuff has been moved to its own repo:
    https://github.com/ansible-community/github-docs-build  (samccann,
    16:54:49)
  * this allows collection owners to create collection docs during the
    PR to validate they work   (samccann, 16:55:26)
  * documentation on this feature just starting but is at
    https://github.com/ansible-community/github-docs-build/wiki
    (samccann, 16:57:56)

Meeting ended at 16:59:46 UTC.




Action Items
------------
* @samccann to turn community docs idea into a community-topic proposal
  and share on bullorn and reddit
* @samccann to turn changelog guidance into community-topic to widen
  discussion/feedback




Action Items, by person
-----------------------
* samccann
  * @samccann to turn community docs idea into a community-topic
    proposal and share on bullorn and reddit
  * @samccann to turn changelog guidance into community-topic to widen
    discussion/feedback
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (89)
* briantist (25)
* acozine (23)
* felixfontein (21)
* bcoca (13)
* zodbot (11)
* gwmngilfen-work (5)
* gundalow (5)
* remindbot[m] (3)
* Gwmngilfen (0)




Generated by `MeetBot`_ 0.4

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