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