===========================================
#ansible-docs: Docs Working Group aka DaWGs
===========================================


Meeting started by acozine at 14:31:33 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-06-16/docs_working_group_aka_dawgs.2020-06-16-14.31.log.html
.



Meeting summary
---------------
* priority PRs  (acozine, 14:37:19)
  * LINK: https://github.com/ansible/ansible/pull/69832   (samccann,
    14:38:28)
  * AGREED: add a link to intersphinx  for M() and R() use on third
    party docsite  (samccann, 14:48:00)
  * LINK: https://github.com/ansible/ansible/pull/70064   (acozine,
    14:48:50)
  * 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)
  * LINK:
    https://github.com/ansible/ansible/pull/68498#issuecomment-609404786
    (felixfontein, 15:08:41)
  * LINK:
    https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_2.10.html#command-line
    (samccann, 15:13:20)

* changelogs in the collections ecosystem  (acozine, 15:15:00)
  * we still have a bunch of changelog fragments in ansible/ansible that
    really should be in their appropriate collections  (samccann,
    15:15:31)
  * the fragments have mostly been deleted from ansible/ansible, but
    probably not been inserted in the corresponding collection
    (felixfontein, 15:15:56)
  * 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)
  * 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)
  * 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)

* old porting guide entries in ansible/ansible  (samccann, 15:27:56)
  * 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)
  * 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)

* docs pipeline  (samccann, 15:39:08)
  * 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)
  * gist  with all collected information on how deprecation now works:
    https://gist.github.com/felixfontein/06995539f9fc7b06150ab3fe5d80c14e
    (samccann, 15:39:35)
  * ACTION: samccann to find collection that is already using FQCN in
    the module docs and pass to abadger1999  (samccann, 15:45:01)
  * LINK:
    https://github.com/ansible-collections/community.crypto/blob/master/plugins/modules/openssh_keypair.py#L13
    (acozine, 15:48:31)
  * FQCN used in https://github.com/ansible-collections/arista.eos and
    https://github.com/ansible-collections/community.crypto  (samccann,
    15:50:53)

* open floor  (acozine, 15:53:49)

Meeting ended at 16:00:26 UTC.




Action Items
------------
* 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 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 to find collection that is already using FQCN in the module
  docs and pass to abadger1999




Action Items, by person
-----------------------
* abadger1999
  * samccann to find collection that is already using FQCN in the module
    docs and pass to abadger1999
* felixfontein
  * 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
* gundalow
  * 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 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
  * 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 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 to find collection that is already using FQCN in the module
    docs and pass to abadger1999
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* acozine (106)
* samccann (77)
* felixfontein (68)
* abadger1999 (27)
* Guest63935 (8)
* zodbot (7)
* gundalow (2)




Generated by `MeetBot`_ 0.1.4

.. _`MeetBot`: http://wiki.debian.org/MeetBot