#ansible-docs: Docs Working Group aka DaWGs

Meeting summary

1. opening chatter (acozine, 15:00:32)
   
2. collection extra docs and Ansible 4.1 release . . . (acozine, 15:07:34)
   1. community.crypto, community.general and community.docker have docs/docsite folders (samccann, 15:08:25)
   2. these should show up in their new place on docs.ansible.com/ansible after 4.1.0 releases (aka collection must be in the Ansible package before the docs will show up) (samccann, 15:09:04)
   3. see https://docs.ansible.com/ansible/devel/dev_guide/developing_collections_structure.html#docs-directory for details on how to move scenario guides to a collection repo (samccann, 15:13:02)
   4. and see https://github.com/ansible-collections/amazon.aws/pull/362 for an example of a moved scenario guide (samccann, 15:13:25)
   5. use `antsibull-lint collection-docs` for some first sanity checks (samccann, 15:16:15)
   
   
3. Ansible Sphinx theme (acozine, 15:26:54)
   1. ansible-theme should be mergable soon. One final check on staging (samccann, 15:30:37)
   
   
4. semantic markup (acozine, 15:32:25)
   1. https://github.com/ansible/ansible/pull/73137 (acozine, 15:32:36)
   2. discussion from https://github.com/ansible/ansible/pull/73137 (acozine, 15:32:53)
   3. considering leaving `M()` as is, and adding `P(name#type)` for all plugins e.g. `P(ansible.builtin.apt#module)` etc (samccann, 15:39:54)
   
   
5. open floor (acozine, 15:46:46)
   1. https://hackmd.io/lAJfWYrlT3Gg1VXYGBoZtA (acozine, 15:56:16)
   2. we will be trying to create 'personas' and how each different ansible docs reader is looking for info in our docs. More to come (samccann, 15:59:07)
   3. agenda items can be added to https://github.com/ansible/community/issues/579 at any time by anyone (samccann, 16:02:08)

Action items

1. (none)

People present (lines said)

1. acozine (106)
2. felixfontein (46)
3. samccann (42)
4. zodbot (8)
5. briantist (8)
6. cyberpear (2)
7. lmodemal (2)
8. gundalow (1)
9. baptistemm (1)