acozine's meeting titled "Docs Working Group aka DaWGs" ended in
#ansible-docs
by notifications@fedoraproject.org
Notification time stamped 2021-01-12 17:42:40 UTC
===========================================
#ansible-docs: Docs Working Group aka DaWGs
===========================================
Meeting started by acozine at 16:01:34 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-01-12/docs_working_gr...
.
Meeting summary
---------------
* opening chatter (acozine, 16:01:38)
* filter/test plugin docs (acozine, 16:09:02)
* role argspec update (acozine, 16:13:25)
* decided to place the argspec in `meta/main.yml` under the
`argument_specs` entry. that was to satisfy a request from
felixfontein for future docs reasons. (samccann, 16:14:32)
* we have no doc specific requirements spec'd for it at this time, but
i would expect that to be filled out after the initial PoC phase.
(samccann, 16:14:42)
* 2.11 you can expect: 1) validates role args at task execution time
from spec in meta/main.yml, 2) ansible-doc support to output role
entrypoints and descriptions. (samccann, 16:19:03)
* the role arg spec format will be a subset of module arg spec. they
will, in fact, share the same code. (samccann, 16:19:26)
* ACTION: tadeboro to investigate ways to move forward with role docs
as we wait for role argspec validation (acozine, 16:28:59)
* removing the "update on role argspec" from the agenda for the next
few months, will add it back as a regular item after 2.11 release
(acozine, 16:29:33)
* template for collection `/docs/` folder (acozine, 16:30:46)
* directory: we're going to propose allocating a specific subdirectory
in the collection for building docsite content from. Nothing
unrelated to the docsite should be placed there. (abadger1999,
16:38:44)
* need 'some way' to make labels unique across all the collections
(samccann, 16:39:17)
* an example of a potential label would be `..
_anscoll_community_crypto_LABEL::` (_anscoll_community_crypto_ is
the part that uniquifies the label. (samccann, 16:45:35)
* need a way to exclude collections whose docs are bad (for instance,
contain conflicting labels) or include the collections that are
known good. (abadger1999, 16:49:29)
* ACTION: acozine to summarize today's conversation in a proposal or
issue (acozine, 17:01:10)
* LINK:
https://github.com/sensu/sensu-go-ansible/blob/master/docs/Makefile.custom
is what we do to render things. (tadeboro, 17:04:19)
* docs user survey results (acozine, 17:05:32)
* 27% said they were "very happy" and another 33% said they were
"slightly happy" with the Ansible docs (samccann, 17:07:49)
* only 9.6% said they were "very unhappy" (samccann, 17:08:05)
* LINK: https://stats.eng.ansible.com/apps/docs/docs-survey.html
(gwmngilfen, 17:10:02)
* raw data from the survey (more insights to come later ) -
https://stats.eng.ansible.com/apps/docs/docs-survey.html (samccann,
17:11:25)
* open floor (acozine, 17:16:24)
* LINK:
https://github.com/ansible-community/antsibull/pull/231#issuecomment-7573...
(felixfontein, 17:16:48)
Meeting ended at 17:42:40 UTC.
Action Items
------------
* tadeboro to investigate ways to move forward with role docs as we wait
for role argspec validation
* acozine to summarize today's conversation in a proposal or issue
Action Items, by person
-----------------------
* acozine
* acozine to summarize today's conversation in a proposal or issue
* tadeboro
* tadeboro to investigate ways to move forward with role docs as we
wait for role argspec validation
* **UNASSIGNED**
* (none)
People Present (lines said)
---------------------------
* acozine (137)
* felixfontein (51)
* samccann (49)
* abadger1999 (32)
* tadeboro (18)
* gwmngilfen (16)
* zodbot (14)
* Shrews (8)
* bcoca (3)
* alongchamps (2)
* gundalow (1)
* dericcrago (1)
Generated by `MeetBot`_ 0.1.4
.. _`MeetBot`: http://wiki.debian.org/MeetBot
https://meetbot.fedoraproject.org/ansible-docs/2021-01-12/docs_working_gr...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...