===========================================
#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_group_aka_dawgs.2021-01-12-16.01.log.html
.



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-757371797
    (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