#ansible-docs: Docs Working Group aka DaWGs

Meeting started by acozine at 14:31:25 UTC (full logs).

Meeting summary

  1. agenda review (acozine, 14:31:38)
    1. https://github.com/ansible/ansible/pull/69833 is the PR to cover docs for 69727 (samccann, 14:38:38)
    2. https://github.com/ansible/ansible/pull/67291 (felixfontein, 14:42:15)

  2. collections docs pipeline update (acozine, 14:45:32)
    1. antsibull docs pipeline PR merged.. followon bugs and features to follow (samccann, 14:47:43)
    2. some notes on high leve use of docs pipeline (draft) - https://github.com/ansible-community/antsibull/wiki/ansibulled-docs-design-plan#use-cases (samccann, 14:51:46)
    3. looking for feedback on those use cases or any others folks have in mind (samccann, 14:52:39)
    4. https://github.com/ansible/ansible/pull/69796/ <== This one touches plugin_formatter code but I believe the new code will already the handle the proposed changes so I think it will just be an enhancement for ansible-doc. (abadger1999, 14:56:13)
    5. https://github.com/ansible/ansible/pull/69797 <== this one will probably need to be pushed into the new docss pipeline code (inside of antsibull) (abadger1999, 15:00:54)
    6. can test the WIP collections docs pipeline using the branch from https://github.com/ansible/ansible/pull/59761 (acozine, 15:01:49)
    7. https://github.com/ansible-community/antsibull/pull/62 already does that (partially) (felixfontein, 15:01:58)
    8. ACTION: abadger199 merged https://github.com/ansible/ansible/pull/69797 (abadger1999, 15:08:32)
    9. equivalent functionality of 69797 should be added to the new docs pipeline in https://github.com/ansible-community/antsibull/pull/62 (abadger1999, 15:08:59)
    10. https://github.com/ansible-community/antsibull/issues/54#issue-627447828 (abadger1999, 15:11:41)
    11. next steps for docs WG on the new docs pipeline include 1. review docs design plan, identify gaps; 2. test new pipeline by pulling the branch from PR 59761 (samccann, 15:12:35)
    12. ACTION: add 'how to build devel docs' to agenda (samccann, 15:20:42)

  3. changelogs and porting guides for 2.10 (acozine, 15:21:50)
    1. https://github.com/ansible/ansible/pull/69313 still waiting on merge to get ansibull-changelog for ansible/ansible (samccann, 15:25:54)
    2. AGREED: we will need a follow-up PR to 69313 to make ansible/ansible's changelogs include the new categories of changes, with documentation (acozine, 15:40:42)

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


Meeting ended at 15:46:31 UTC (full logs).

Action items

  1. abadger199 merged https://github.com/ansible/ansible/pull/69797
  2. add 'how to build devel docs' to agenda


People present (lines said)

  1. acozine (101)
  2. felixfontein (67)
  3. abadger1999 (44)
  4. samccann (25)
  5. zodbot (8)
  6. dmellado (1)
  7. cbudz (1)
  8. briantist (1)


Generated by MeetBot 0.1.4.