#ansible-docs: Docs Working Group aka DaWGs

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

Meeting summary

  1. priority PRs (acozine, 14:37:19)
    1. https://github.com/ansible/ansible/pull/69832 (samccann, 14:38:28)
    2. AGREED: add a link to intersphinx for M() and R() use on third party docsite (samccann, 14:48:00)
    3. https://github.com/ansible/ansible/pull/70064 (acozine, 14:48:50)
    4. AGREED: changelog fragments should not use R() and M() and any such linking as it doesn't work in raw rst, where the user will see it per collection. (samccann, 15:04:31)
    5. https://github.com/ansible/ansible/pull/68498#issuecomment-609404786 (felixfontein, 15:08:41)
    6. https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_2.10.html#command-line (samccann, 15:13:20)

  2. changelogs in the collections ecosystem (acozine, 15:15:00)
    1. we still have a bunch of changelog fragments in ansible/ansible that really should be in their appropriate collections (samccann, 15:15:31)
    2. the fragments have mostly been deleted from ansible/ansible, but probably not been inserted in the corresponding collection (felixfontein, 15:15:56)
    3. https://github.com/ansible/ansible/issues/67654 and https://github.com/ansible/ansible/pull/69491, which says it's #6 but doesn't reference the other 5 (acozine, 15:21:08)
    4. this shows 5 of the 6 changelog removal PRs: https://github.com/ansible/ansible/pulls?q=is%3Apr+reap+in%3Atitle+is%3Aclosed (samccann, 15:24:10)
    5. ACTION: samccann gundalow - remind collection owners, "please try to collect all changelog fragments added after 2.9 for content in your collection, so the changelog for ACD 2.10 will mentioned *everything* changed after 2.9.0" (samccann, 15:25:08)

  3. old porting guide entries in ansible/ansible (samccann, 15:27:56)
    1. ACTION: samccann gundalow contact collection owners to ask them to move their 2.10 porting guide entries into changelog fragments and point them to felixfontein's docs on the correct categories (samccann, 15:35:24)
    2. PRs for reference of moving fragments / porting guide entries: https://github.com/ansible-collections/community.general/pull/156 https://github.com/ansible-collections/community.general/pull/512 (samccann, 15:37:21)

  4. docs pipeline (samccann, 15:39:08)
    1. antsibull PR for deprecation-by-date and collection name, so hopefully soon the docs pipeline will support that: https://github.com/ansible-community/antsibull/pull/62 (samccann, 15:39:25)
    2. gist with all collected information on how deprecation now works: https://gist.github.com/felixfontein/06995539f9fc7b06150ab3fe5d80c14e (samccann, 15:39:35)
    3. ACTION: samccann to find collection that is already using FQCN in the module docs and pass to abadger1999 (samccann, 15:45:01)
    4. https://github.com/ansible-collections/community.crypto/blob/master/plugins/modules/openssh_keypair.py#L13 (acozine, 15:48:31)
    5. FQCN used in https://github.com/ansible-collections/arista.eos and https://github.com/ansible-collections/community.crypto (samccann, 15:50:53)

  5. open floor (acozine, 15:53:49)


Meeting ended at 16:00:26 UTC (full logs).

Action items

  1. samccann gundalow - remind collection owners, "please try to collect all changelog fragments added after 2.9 for content in your collection, so the changelog for ACD 2.10 will mentioned *everything* changed after 2.9.0"
  2. samccann gundalow contact collection owners to ask them to move their 2.10 porting guide entries into changelog fragments and point them to felixfontein's docs on the correct categories
  3. samccann to find collection that is already using FQCN in the module docs and pass to abadger1999


Action items, by person

  1. abadger1999
    1. samccann to find collection that is already using FQCN in the module docs and pass to abadger1999
  2. felixfontein
    1. samccann gundalow contact collection owners to ask them to move their 2.10 porting guide entries into changelog fragments and point them to felixfontein's docs on the correct categories
  3. gundalow
    1. samccann gundalow - remind collection owners, "please try to collect all changelog fragments added after 2.9 for content in your collection, so the changelog for ACD 2.10 will mentioned *everything* changed after 2.9.0"
    2. samccann gundalow contact collection owners to ask them to move their 2.10 porting guide entries into changelog fragments and point them to felixfontein's docs on the correct categories
  4. samccann
    1. samccann gundalow - remind collection owners, "please try to collect all changelog fragments added after 2.9 for content in your collection, so the changelog for ACD 2.10 will mentioned *everything* changed after 2.9.0"
    2. samccann gundalow contact collection owners to ask them to move their 2.10 porting guide entries into changelog fragments and point them to felixfontein's docs on the correct categories
    3. samccann to find collection that is already using FQCN in the module docs and pass to abadger1999


People present (lines said)

  1. acozine (106)
  2. samccann (77)
  3. felixfontein (68)
  4. abadger1999 (27)
  5. Guest63935 (8)
  6. zodbot (7)
  7. gundalow (2)


Generated by MeetBot 0.1.4.