#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. opening chatter (samccann, 16:02:05)
   
2. Action Item Review (samccann, 16:07:54)
   1. agenda - https://github.com/ansible/community/issues/579#issuecomment-983039814 (samccann, 16:08:20)
   2. 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)
   
   
3. Responsive parameter tables (samccann, 16:12:20)
   1. https://github.com/ansible-community/antsibull/pull/335 (samccann, 16:12:34)
   2. 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)
   3. ACTION: samccann to publish https://github.com/ansible-community/antsibull/pull/335 to test before we merge (samccann, 16:18:26)
   4. ACTION: felixfontein to merge 335 (responsive parameters) and move forward with next steps to an antsibull release (samccann, 16:24:43)
   
   
4. semantic markup (samccann, 16:25:00)
   1. 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)
   2. next step is a formal spec for this to be reviewed in community and then internally for these dependent products (samccann, 16:33:01)
   3. ACTION: samccann felixfontein -work on semantic markup formal spec in hackmd (samccann, 16:33:33)
   
   
5. docs vs docs-tooling and attracting more contributors (samccann, 16:35:43)
   1. 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)
   2. 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)
   3. ACTION: samccann to revamp the agenda to frontload some documentation issues/PRs/ideas before the tooling stuff...make nice headers ;-) (samccann, 16:46:19)
   
   
6. Open Floor (samccann, 16:50:44)
   1. ACTION: Gwmngilfen to work on finalizing linking metadata for collections and turning it into a proposal (samccann, 16:55:16)
   2. https://github.com/matrix-org/matrix-doc/pull/2545 (gwmngilfen-work, 16:56:22)

Action items

1. samccann to publish https://github.com/ansible-community/antsibull/pull/335 to test before we merge
2. felixfontein to merge 335 (responsive parameters) and move forward with next steps to an antsibull release
3. samccann felixfontein -work on semantic markup formal spec in hackmd
4. 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
5. samccann to revamp the agenda to frontload some documentation issues/PRs/ideas before the tooling stuff...make nice headers ;-)
6. Gwmngilfen to work on finalizing linking metadata for collections and turning it into a proposal

Action items, by person

1. felixfontein
   1. felixfontein to merge 335 (responsive parameters) and move forward with next steps to an antsibull release
   2. samccann felixfontein -work on semantic markup formal spec in hackmd
2. samccann
   1. samccann to publish https://github.com/ansible-community/antsibull/pull/335 to test before we merge
   2. samccann felixfontein -work on semantic markup formal spec in hackmd
   3. 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
   4. samccann to revamp the agenda to frontload some documentation issues/PRs/ideas before the tooling stuff...make nice headers ;-)

People present (lines said)

1. samccann (90)
2. felixfontein (45)
3. acozine (39)
4. gwmngilfen-work (16)
5. gundalow (11)
6. zodbot (7)
7. remindbot[m] (3)
8. FelixFontein[m] (1)