=========================================== #ansible-docs: Docs Working Group aka DaWGs =========================================== Meeting started by acozine at 15:00:27 UTC. The full logs are available at https://meetbot.fedoraproject.org/ansible-docs/2021-06-08/docs_working_group_aka_dawgs.2021-06-08-15.00.log.html . Meeting summary --------------- * opening chatter (acozine, 15:00:32) * collection extra docs and Ansible 4.1 release . . . (acozine, 15:07:34) * community.crypto, community.general and community.docker have docs/docsite folders (samccann, 15:08:25) * 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) * 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) * and see https://github.com/ansible-collections/amazon.aws/pull/362 for an example of a moved scenario guide (samccann, 15:13:25) * use `antsibull-lint collection-docs` for some first sanity checks (samccann, 15:16:15) * Ansible Sphinx theme (acozine, 15:26:54) * ansible-theme should be mergable soon. One final check on staging (samccann, 15:30:37) * semantic markup (acozine, 15:32:25) * LINK: https://github.com/ansible/ansible/pull/73137 (acozine, 15:32:36) * discussion from https://github.com/ansible/ansible/pull/73137 (acozine, 15:32:53) * 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) * open floor (acozine, 15:46:46) * LINK: https://hackmd.io/lAJfWYrlT3Gg1VXYGBoZtA (acozine, 15:56:16) * 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) * agenda items can be added to https://github.com/ansible/community/issues/579 at any time by anyone (samccann, 16:02:08) Meeting ended at 16:03:08 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * acozine (106) * felixfontein (46) * samccann (42) * zodbot (8) * briantist (8) * cyberpear (2) * lmodemal (2) * gundalow (1) * baptistemm (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot