#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. opening chatter (acozine, 14:31:16)
   1. https://github.com/ansible/community/issues/521 is our agenda spot (acozine, 14:37:24)
   2. https://github.com/ansible/community/issues/521#issuecomment-704386942 (samccann, 14:38:28)
   
   
2. clarifying RH supported version vs. latest community version (acozine, 14:40:30)
   1. https://github.com/ansible/ansible/issues/72199 (acozine, 14:40:32)
   2. ACTION: samccann to create separate banners to denote latest vs rh latest and test on jenkins (samccann, 15:03:08)
   3. we will update banners on latest/2.10 and 2.9 to distinguish what is upstream latest and what is downstream latest releases (samccann, 15:03:35)
   
   
3. removing docs source files from the Ansible tarball (acozine, 15:05:22)
   1. https://github.com/ansible-collections/overview/discussions/120 (acozine, 15:05:25)
   2. are collection RST files useful to anyone? (samccann, 15:10:16)
   3. Legal might say we cannot remove them (samccann, 15:10:25)
   4. people might be using the RST from ansible-base since that's been around a lot longer (samccann, 15:10:41)
   5. if we remove .rst from Ansible package, we can also create an ansible-documentation package that includes them, and maybe the generated HTML to help those looking for offline docs (samccann, 15:16:49)
   6. AGREED: - we will propose that we remove all .rst files from Ansible package and provide a separate ansible-docs package that includes the rst files and generated HTML files for offline use. (samccann, 15:21:17)
   7. ACTION: socialize this proposal to reddit/mailing lists, and internal Powers That Be for comments etc https://github.com/ansible-collections/overview/discussions/120 (samccann, 15:21:51)
   
   
4. speed-reading other topics (acozine, 15:24:00)
   
5. open floor (acozine, 15:35:29)
   1. https://github.com/felixfontein/ansible-basic-sphinx-ext (samccann, 15:36:49)
   2. this could be used to help collection owners create their own docsite - https://ansible.fontein.de/ (samccann, 15:39:52)
   3. source https://github.com/felixfontein/felix-ansible-docsite (samccann, 15:40:01)

Action items

1. samccann to create separate banners to denote latest vs rh latest and test on jenkins
2. socialize this proposal to reddit/mailing lists, and internal Powers That Be for comments etc https://github.com/ansible-collections/overview/discussions/120

Action items, by person

1. samccann
   1. samccann to create separate banners to denote latest vs rh latest and test on jenkins

People present (lines said)

1. samccann (103)
2. acozine (102)
3. felixfontein (65)
4. gundalow (17)
5. zodbot (10)
6. tributarian (7)
7. zbr (3)
8. lmodemal (2)
9. tadeboro (1)