#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. opening chatter (samccann, 16:00:17)
   
2. Community guide docs (samccann, 16:04:32)
   1. starting a project to combine community docs from ansible/ansible and other repos where it exists. https://hackmd.io/3Cvy2N8tTfSrUzqYZmfEHA (samccann, 16:04:44)
   2. step 1 - combine the info (samccann, 16:06:11)
   3. step 2 - publish (possibly from different repos) (samccann, 16:06:23)
   4. ACTION: @samccann to turn community docs idea into a community-topic proposal and share on bullorn and reddit (samccann, 16:24:36)
   
   
3. Better changelog guidelines (samccann, 16:26:03)
   1. We had some feedback to create better guidance for developers on what to include in changelog fragments - https://hackmd.io/ZdymdeUSQNeM0hMjsn7vig (samccann, 16:26:29)
   2. some ansible-core changelogs impact other developers. Most/all collection changelogs impact end users (samccann, 16:34:40)
   3. ACTION: @samccann to turn changelog guidance into community-topic to widen discussion/feedback (samccann, 16:45:06)
   
   
4. DocTools (samccann, 16:45:27)
   1. simplified module tables are up on devel! https://docs.ansible.com/ansible/devel/collections/community/general/aix_lvol_module.html (samccann, 16:45:43)
   2. good samples of this https://docs.ansible.com/ansible/devel/collections/community/crypto/acme_certificate_module.html#parameters and https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/hashi_vault_lookup.html#parameters and https://docs.ansible.com/ansible/devel/collections/cisco/ios/ios_bgp_address_family_module.html#parameters (samccann, 16:52:26)
   
   
5. Open Floor (samccann, 16:53:33)
   1. The docs build github stuff has been moved to its own repo: https://github.com/ansible-community/github-docs-build (samccann, 16:54:49)
   2. this allows collection owners to create collection docs during the PR to validate they work (samccann, 16:55:26)
   3. documentation on this feature just starting but is at https://github.com/ansible-community/github-docs-build/wiki (samccann, 16:57:56)

Action items

1. @samccann to turn community docs idea into a community-topic proposal and share on bullorn and reddit
2. @samccann to turn changelog guidance into community-topic to widen discussion/feedback

Action items, by person

1. samccann
   1. @samccann to turn community docs idea into a community-topic proposal and share on bullorn and reddit
   2. @samccann to turn changelog guidance into community-topic to widen discussion/feedback

People present (lines said)

1. samccann (89)
2. briantist (25)
3. acozine (23)
4. felixfontein (21)
5. bcoca (13)
6. zodbot (11)
7. gwmngilfen-work (5)
8. gundalow (5)
9. remindbot[m] (3)
10. Gwmngilfen (0)