#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. opening chatter (samccann, 16:00:13)
   
2. Documentation updates (samccann, 16:03:04)
   1. Meeting time will say the current UTC until Europe goes to DST (March 27th) so for those in the US, this meeting will be one hour later for 2 weeks. (samccann, 16:05:08)
   2. always looking for help on the backlog - issues - https://github.com/ansible/ansible/issues?q=is%3Aopen+is%3Aissue+label%3Adocs and PRs - https://github.com/ansible/ansible/pulls?q=is%3Aopen+is%3Apr+label%3Adocs (samccann, 16:11:56)
   
   
3. semantic markup (samccann, 16:13:58)
   1. as a reminder, the proposal as currently designed is not a part of the Ansible/RH roadmap for this year (samccann, 16:14:27)
   2. --json basically dumps the documentation as-is from the plugins, and if the plugin documentation uses semantic markup, it's in the --json output (samccann, 16:20:45)
   3. So we are on hold with semantic markup until it lands in an official product roadmap (samccann, 16:21:06)
   
   
4. redirects (samccann, 16:23:28)
   1. to get Ansible collection redirects working 'way back in ansible 3' we had to remove the redirects that went from old docs.ansible.com/ansible/foo to docs.ansible.com/ansible/<version>/foo (samccann, 16:24:16)
   2. https://github.com/ansible/ansible/issues/77204 (ariordan, 16:25:38)
   3. ACTION: samccann to ask webserver folks for access logs to see how often these old urls are used (samccann, 16:27:20)
   4. ACTION: samccann to check web analytics for these older unversioned urls (samccann, 16:30:47)
   5. redirect removed by https://github.com/ansible/docsite/pull/38 (samccann, 16:34:00)
   6. the relevant diffs - https://pastebin.com/kMvgKFLJ (samccann, 16:36:22)
   
   
5. doctools (samccann, 16:37:32)
   1. looking for help on https://github.com/ansible/ansible/issues/77054. Likely requires coding but not even sure where (samccann, 16:38:21)
   2. take a look at https://github.com/ansible-community/antsibull/pull/355 and post comments or +1s etc (samccann, 16:41:53)
   
   
6. Open Floor (samccann, 16:43:38)
   1. https://github.com/ansible-community/antsibull/pull/355/files#diff-81dcd7b3ffe8fe9d6bc5962ad8c9dc1f2053087277f96d24eeffa14549d3f18dR35-R62 <-- that's the stuff for ansible.builtin (felixfontein, 17:05:59)
   2. ACTION: all - review the ansible.builtin links/buttons here - https://github.com/ansible-community/antsibull/pull/355/files#diff-81dcd7b3ffe8fe9d6bc5962ad8c9dc1f2053087277f96d24eeffa14549d3f18dR35-R62 (samccann, 17:06:48)
   3. https://ansible.fontein.de/collections/ansible/builtin/ (felixfontein, 17:06:53)
   4. builtin links/buttons - https://ansible.fontein.de/collections/ansible/builtin/ (samccann, 17:07:14)

Action items

1. samccann to ask webserver folks for access logs to see how often these old urls are used
2. samccann to check web analytics for these older unversioned urls
3. all - review the ansible.builtin links/buttons here - https://github.com/ansible-community/antsibull/pull/355/files#diff-81dcd7b3ffe8fe9d6bc5962ad8c9dc1f2053087277f96d24eeffa14549d3f18dR35-R62

Action items, by person

1. samccann
   1. samccann to ask webserver folks for access logs to see how often these old urls are used
   2. samccann to check web analytics for these older unversioned urls

People present (lines said)

1. samccann (107)
2. acozine (39)
3. felixfontein (39)
4. gwmngilfen-work (23)
5. zodbot (9)
6. briantist (7)
7. ariordan (5)
8. thedoubl3j (4)
9. amott[m] (4)
10. remindbot[m] (3)
11. amott (0)
12. Gwmngilfen (0)