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


Meeting started by samccann at 16:02:04 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-12-07/documentation_working_group_aka_dawgs.2021-12-07-16.02.log.html
.



Meeting summary
---------------
* opening chatter  (samccann, 16:02:05)

* Action Item Review  (samccann, 16:07:54)
  * agenda -
    https://github.com/ansible/community/issues/579#issuecomment-983039814
    (samccann, 16:08:20)
  * action items still pending - expand/collapse, and better
    linking/metadata for collection pages, and 'when should a playbook
    become a role' doc ideas  (samccann, 16:11:38)

* Responsive parameter tables  (samccann, 16:12:20)
  * LINK: https://github.com/ansible-community/antsibull/pull/335
    (samccann, 16:12:34)
  * devel docs also use 'known good' requirements. If we want to publish
    these responsive tables only to devel for a time, we will need to
    update the jenkins builds to do that (for just nightly builds to
    devel)  (samccann, 16:13:28)
  * ACTION: samccann to publish
    https://github.com/ansible-community/antsibull/pull/335  to test
    before we merge  (samccann, 16:18:26)
  * ACTION: felixfontein to merge 335 (responsive parameters) and move
    forward with next steps to an antsibull release  (samccann,
    16:24:43)

* semantic markup  (samccann, 16:25:00)
  * since semantic markup impacts products like Automation Hub, we
    cannot merge these until core-2.14 timeframe as all the roadmaps
    based on 2.13 have been finalized.  (samccann, 16:32:40)
  * next step is a formal spec for this to be reviewed in community and
    then internally for these dependent products  (samccann, 16:33:01)
  * ACTION: samccann felixfontein -work on semantic markup formal spec
    in hackmd   (samccann, 16:33:33)

* docs vs docs-tooling and attracting more contributors  (samccann,
  16:35:43)
  * ACTION: samccann cybette work on a 'Help wanted' section on the
    bullorn to add 'easyfix' issues or other ideas where people can hop
    in and help  (samccann, 16:43:02)
  * we should highlight a part of the agenda dedicated to documentation
    so newcomers know when we will talk docs vs docs tooling  (samccann,
    16:45:38)
  * ACTION: samccann to revamp the agenda to frontload some
    documentation issues/PRs/ideas before the tooling stuff...make nice
    headers ;-)  (samccann, 16:46:19)

* Open Floor  (samccann, 16:50:44)
  * ACTION: Gwmngilfen to work on finalizing linking metadata for
    collections and turning it into a proposal  (samccann, 16:55:16)
  * LINK: https://github.com/matrix-org/matrix-doc/pull/2545
    (gwmngilfen-work, 16:56:22)

Meeting ended at 16:56:58 UTC.




Action Items
------------
* samccann to publish
  https://github.com/ansible-community/antsibull/pull/335  to test
  before we merge
* felixfontein to merge 335 (responsive parameters) and move forward
  with next steps to an antsibull release
* samccann felixfontein -work on semantic markup formal spec in hackmd
* samccann cybette work on a 'Help wanted' section on the bullorn to add
  'easyfix' issues or other ideas where people can hop in and help
* samccann to revamp the agenda to frontload some documentation
  issues/PRs/ideas before the tooling stuff...make nice headers ;-)
* Gwmngilfen to work on finalizing linking metadata for collections and
  turning it into a proposal




Action Items, by person
-----------------------
* felixfontein
  * felixfontein to merge 335 (responsive parameters) and move forward
    with next steps to an antsibull release
  * samccann felixfontein -work on semantic markup formal spec in hackmd
* samccann
  * samccann to publish
    https://github.com/ansible-community/antsibull/pull/335  to test
    before we merge
  * samccann felixfontein -work on semantic markup formal spec in hackmd
  * samccann cybette work on a 'Help wanted' section on the bullorn to
    add 'easyfix' issues or other ideas where people can hop in and help
  * samccann to revamp the agenda to frontload some documentation
    issues/PRs/ideas before the tooling stuff...make nice headers ;-)
* **UNASSIGNED**
  * Gwmngilfen to work on finalizing linking metadata for collections
    and turning it into a proposal




People Present (lines said)
---------------------------
* samccann (90)
* felixfontein (45)
* acozine (39)
* gwmngilfen-work (16)
* gundalow (11)
* zodbot (7)
* remindbot[m] (3)
* FelixFontein[m] (1)




Generated by `MeetBot`_ 0.4

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