#ansible-docs: Docs Working Group aka DaWGs

Meeting summary

1. opening chatter (acozine, 14:32:16)
   
2. changelogs and porting guides (acozine, 14:36:52)
   1. removing collections porting guide entries from ansible-base porting guide - https://github.com/ansible-community/ansible-build-data/pull/23 (samccann, 14:39:45)
   2. inserting release summaries for new releases https://github.com/ansible-community/antsibull/pull/164 (samccann, 14:40:22)
   3. https://github.com/ansible-community/ansible-build-data/blob/b9c8acdc6b32ca2e4866e4784e9f2eb68b1a1042/2.10/CHANGELOG-v2.10.rst works again (felixfontein, 14:41:33)
   4. community.grafana has no changelog we can automatically include, and TBD on the state of the 3rd party collections (samccann, 14:42:33)
   5. we can now backport `security_fix` changes to all maintained versions (new categories backported to 2.9 and 2.8) (samccann, 14:47:26)
   6. https://github.com/ansible-community/ansible-build-data/pull/25/files#diff-34e94ff06c034caba36782cfa3bd97eaR23 (acozine, 14:49:25)
   
   
3. banners and other docsite formatting (acozine, 14:57:30)
   1. http://docs.testing.ansible.com/ansible/2.8/dev_guide/developing_modules.html (acozine, 15:01:24)
   2. http://docs.testing.ansible.com/ansible/2.8/dev_guide/developing_modules.html (acozine, 15:07:39)
   3. banner PR https://github.com/ansible/ansible/pull/71077 produces problem at http://docs.testing.ansible.com/ansible/2.8/dev_guide/developing_modules.html (samccann, 15:08:09)
   4. banner PR attempting to not show devel banner on pages that have devel in the page title, as above (samccann, 15:08:33)
   5. fix id per command and consider putting the `</div>` into the `document.write()` statement which prints the `<div>`, to avoid such problems (samccann, 15:11:38)
   6. ACTION: - tadeboro to provide sphinx example for parameterized doc generation (when time permits) (samccann, 15:20:05)
   7. - the reusable sphinx theme would be good to adopt, but we need to figure out a way to test changes so it won't break all the places currently using it (samccann, 15:30:15)
   8. explore options for publishing individual PR changes to the test site in a way that makes them easy to find, for example `PR2.testing.ansible.com` or similar, with security and cleanup (acozine, 15:37:06)
   
   
4. docs pipeline update (acozine, 15:40:06)
   
5. open floor (acozine, 15:53:13)

Action items

1. - tadeboro to provide sphinx example for parameterized doc generation (when time permits)

Action items, by person

1. tadeboro
   1. - tadeboro to provide sphinx example for parameterized doc generation (when time permits)

People present (lines said)

1. acozine (108)
2. felixfontein (58)
3. samccann (32)
4. abadger1999 (22)
5. baptistemm (20)
6. zodbot (11)
7. tadeboro (10)
8. gundalow (4)
9. cbudz (1)