samccann's meeting titled "Documentation Working Group aka DaWGs"
ended in #ansible-docs
by notifications@fedoraproject.org
Notification time stamped 2022-09-20 16:00:28 UTC
====================================================
#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_w...
.
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/...
(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
https://meetbot.fedoraproject.org/ansible-docs/2022-09-20/documentation_w...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...