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


Meeting started by samccann at 15:00:57 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2022-09-20/documentation_working_group_aka_dawgs.2022-09-20-15.00.log.html
.



Meeting summary
---------------
* Action Item updates:  (samccann, 15:06:11)
  * open - Create tracking issue 'somewhere' to track all the
    collections that SHOULD consider using true/false boolean in
    examples (tho some may not want to for $REASONS)  (samccann,
    15:06:24)
  * resolved - merged antsibull-docs update to docs requirements. Will
    need to schedule remaining requirements updates for later this
    Autumn  (samccann, 15:07:15)
  * resolved - collection owners fixed a few broken docs links in their
    Galaxy docsite links etc  (samccann, 15:08:04)

* Hacktoberfest  (samccann, 15:14:37)
  * we hope to participate in Hactoberfest by creating a batch of
    easy-fix issues to help us clean up the docs. See
    https://hacktoberfest.com/participation/ for what this is
    (samccann, 15:15:11)
  * initial brainstorming ideas of what we could fix -
    https://hackmd.io/gNQ2TQW8T4ilcZc8JAM5fQ  (samccann, 15:16:29)
  * ACTION: samccann to ask community team if someone has rights to add
    hacktoberfest topic to all collections (esp new ones as this was
    done last year for existing collections)  (samccann, 15:22:59)
  * should also consider some repos won't want to participate in
    hacktoberfest as it does trigger some 'spam' PRs.  (samccann,
    15:23:49)

* Documentation updates  (samccann, 15:28:42)
  * LINK:
    https://github.com/ansible-collections/community.hashi_vault/pull/299
    (briantist, 15:30:18)
  * LINK:
    https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/index.html#changelog
    (briantist, 15:30:18)
  * ACTION: samccann to open issue(s) to suggest collection owners link
    in their changelogs (such as
    https://github.com/ansible-collections/community.hashi_vault/pull/299)
    (samccann, 15:30:54)
  * IF we have more markup languages for docs in other projects, they
    must have a reasonable display on github  (samccann, 15:34:04)
  * any markup has to also display well on docs.ansible.com as a
    priority  (samccann, 15:34:28)
  * one option - we could recommend RST for ansible projects, but allow
    MD if it already exists, etc.  (samccann, 15:44:11)

* Open Floor  (samccann, 15:47:21)
  * generally leaning toward 'recommending RST but allowing MD
    (samccann, 15:50:22)
  * ACTION: samccann to consider an 'open docs hr' later in the week to
    regularly interact with docs contributors in a friendlier way than
    the expert details that happen in DaWGs meetings  (samccann,
    15:56:18)
  * consider it as a possible optional separate DaWGs meeting
    (samccann, 15:57:19)
  * ACTION: samccann -t to add a link to a separate intro to the agenda
    for welcome/here's what you need to know/ etc so newcomers can
    prepare.  (samccann, 15:58:34)

Meeting ended at 16:00:28 UTC.




Action Items
------------
* samccann to ask community team if someone has rights to add
  hacktoberfest topic to all collections (esp new ones as this was done
  last year for existing collections)
* samccann to open issue(s) to suggest collection owners link in their
  changelogs (such as
  https://github.com/ansible-collections/community.hashi_vault/pull/299)
* samccann to consider an 'open docs hr' later in the week to regularly
  interact with docs contributors in a friendlier way than the expert
  details that happen in DaWGs meetings
* samccann -t to add a link to a separate intro to the agenda for
  welcome/here's what you need to know/ etc so newcomers can prepare.




Action Items, by person
-----------------------
* samccann
  * samccann to ask community team if someone has rights to add
    hacktoberfest topic to all collections (esp new ones as this was
    done last year for existing collections)
  * samccann to open issue(s) to suggest collection owners link in their
    changelogs (such as
    https://github.com/ansible-collections/community.hashi_vault/pull/299)
  * samccann to consider an 'open docs hr' later in the week to
    regularly interact with docs contributors in a friendlier way than
    the expert details that happen in DaWGs meetings
  * samccann -t to add a link to a separate intro to the agenda for
    welcome/here's what you need to know/ etc so newcomers can prepare.
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (95)
* acozine (30)
* briantist (15)
* zodbot (10)
* felixfontein (3)
* DonNaro[m] (2)
* Dhee5096[m] (1)
* Don (0)
* Naro (0)
* Dhee#5096 (0)




Generated by `MeetBot`_ 0.4

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