#ansible-docs: Documentation Working group aka DaWGs Supplemental meeting

Meeting summary

1. opening chatter (samccann, 15:30:44)
   
2. Creating a separate Ansible Collections Documentation site (samccann, 15:35:11)
   1. the current proposal - https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both (samccann, 15:36:12)
   2. a hack of what this might look like - http://docs.testing.ansible.com/ansible/devel/ (samccann, 15:36:27)
   3. TL;DR; of the idea is to create a separate 'Ansible Collections Documentation' and move all scenario etc guides over there, plus the collection index. And leave all the 'what is ansible, how to use ansible, etc on the existing site and call it Ansible Core Documentation (samccann, 15:36:59)
   4. this is in 'interim' solution as there is more work/discussions on creating an improved docs.ansible.com overall. But that is too far out to solve our immediate problem (samccann, 15:39:52)
   5. if we split the docs - core vs Collections - we also impact search. Today it would be two independent searches (samccann, 15:59:38)
   6. ACTION: samccann acozine - review old old DaWGs meeting minutes and other docs that described decisions when we created the docs pipeline but decided NOT to create a /collections/ url on the docsite (samccann, 16:03:43)
   7. we have to decide if we duplicate ansible.builtin to Ansible Collections and rebuild for every ansible-base release, how do we handl the folks who upgrade only based on Ansible releases? They won't get the updated ansible-base until the next Ansible release, but the docs will already be on that future ansible-base release (samccann, 16:14:16)
   8. ACTION: - open a docs PR to explain how to determine ansible-base version vs Ansible package version...`ansible --version` is base, `pip show ansible` is Ansible version (samccann, 16:23:23)
   9. https://github.com/ansible/community/issues/560#issuecomment-700723990 https://meetbot.fedoraproject.org/ansible-meeting/2020-09-29/ansbile_core_irc_public_meeting.2020-09-29-18.58.log.html (felixfontein, 16:24:14)
   10. could use pip show for both ansible-core and Ansible but doesn't solve the problem for those who don't install w/ pip (samccann, 16:25:02)
   11. could say ' pip ... or use the package manager from your OS' (samccann, 16:26:22)
   12. how to we handle google search when we duplicate docs such as installing and using collections vs cannonical url (samccann, 16:36:54)
   13. ACTION: samccann to create pro/con list for the different way forward and/or an outline of which content goes where (samccann, 16:55:54)

Action items

1. samccann acozine - review old old DaWGs meeting minutes and other docs that described decisions when we created the docs pipeline but decided NOT to create a /collections/ url on the docsite
2. - open a docs PR to explain how to determine ansible-base version vs Ansible package version...`ansible --version` is base, `pip show ansible` is Ansible version
3. samccann to create pro/con list for the different way forward and/or an outline of which content goes where

Action items, by person

1. acozine
   1. samccann acozine - review old old DaWGs meeting minutes and other docs that described decisions when we created the docs pipeline but decided NOT to create a /collections/ url on the docsite
2. samccann
   1. samccann acozine - review old old DaWGs meeting minutes and other docs that described decisions when we created the docs pipeline but decided NOT to create a /collections/ url on the docsite
   2. samccann to create pro/con list for the different way forward and/or an outline of which content goes where

People present (lines said)

1. samccann (116)
2. abadger1999 (75)
3. acozine (61)
4. bcoca (16)
5. felixfontein (14)
6. zodbot (10)
7. cybette (3)
8. dericcrago (3)
9. andersson007_ (2)
10. lmodemal (2)
11. gundalow (1)
12. dmsimard (0)