#ansible-docs: Docs Working Group aka DaWGs

Meeting started by acozine at 14:30:54 UTC (full logs).

Meeting summary

  1. changelogs in a collections ecosystem (acozine, 14:35:02)
    1. https://github.com/ansible-collections/overview/issues/18 is the tracking issue (acozine, 14:35:32)
    2. implemented a `trivial` category (which isn't shown in the generated .rst file; useful if f.ex. a collection wants to have a changelog fragment with *every* PR (samccann, 14:37:29)
    3. felixfontein also implemented support that you can use the tool when galaxy.yml isn't there (you'll have to provide more parameters via command-line arguments) (samccann, 14:38:52)
    4. this work is in https://github.com/ansible-community/ansibulled now (samccann, 14:41:46)
    5. documentation: https://github.com/ansible-community/ansibulled/blob/master/docs/changelogs.rst https://github.com/ansible-community/ansibulled/blob/master/docs/changelog.yaml-format.md (felixfontein, 14:42:13)
    6. what's left to do on this - more people testing/using it - first get it on pypi for easy install, and settle on the naming convention for these tools (samccann, 14:48:06)

  2. naming for the new docs build tool (and other related tools) (acozine, 14:48:39)
    1. https://github.com/ansible-community/ansibulled/wiki/Naming-things-is-hard (abadger1999, 14:49:38)
    2. https://github.com/willyg302/antsy (felixfontein, 14:56:17)
    3. https://github.com/adamkpickering/antsy-bull - A configuration management (and more) framework with all the benefits of Ansible and none of the drawbacks (felixfontein, 15:04:07)
    4. AGREED: we will use something like antsy-bull/antsibull - to be discussed/decided later (samccann, 15:13:59)

  3. porting guides (acozine, 15:15:01)
    1. automating porting guide for 2.10 from changelog fragments is a stretch goal, but not committed to it yet. need to determine complexity of rst embedded in a changelog fragment etc (samccann, 15:35:51)
    2. https://github.com/ansible/community/issues/539 in case anyone is interested (felixfontein, 15:37:49)
    3. ACTION: samccann to add 'what do we need to move issues/prs for docs' to thursday's agenda (samccann, 15:43:50)
    4. AGREED: we will have a supplemental DaWGs meeting at 10AM ET on Thursday this week (samccann, 15:44:12)

  4. open floor (acozine, 15:44:32)


Meeting ended at 15:49:26 UTC (full logs).

Action items

  1. samccann to add 'what do we need to move issues/prs for docs' to thursday's agenda


Action items, by person

  1. samccann
    1. samccann to add 'what do we need to move issues/prs for docs' to thursday's agenda


People present (lines said)

  1. acozine (108)
  2. felixfontein (83)
  3. samccann (50)
  4. abadger1999 (41)
  5. briantist (13)
  6. zodbot (11)
  7. dmellado (10)
  8. gundalow (7)
  9. bcoca (4)
  10. Sayee (2)
  11. relrod (1)


Generated by MeetBot 0.1.4.