==================================================== #ansible-docs: Documentation Working Group aka DaWGs ==================================================== Meeting started by samccann at 15:01:20 UTC. The full logs are available at https://meetbot.fedoraproject.org/ansible-docs/2023-06-20/documentation_working_group_aka_dawgs.2023-06-20-15.01.log.html . Meeting summary --------------- * Moving docs out of ansible/ansible (samccann, 15:04:13) * this is part of putting package docs under ansible steering committee/community control. See https://github.com/ansible-community/community-topics/issues/243 (samccann, 15:04:18) * an interim step is to move all docs out to ansible/ansible-documentation. From there, we can iterate faster to get to the point where the community package docs are under community control (likely another repo in ansible-community org) and separate from core docs. (samccann, 15:04:26) * new docs repo is https://github.com/ansible/ansible-documentation (samccann, 15:05:23) * Folks are expressing concerns that we will lose technical contributors to docs in the new repo over time, and the long-term health of the documentation will be impacted by this move (samccann, 15:16:34) * identified risk - the docs lose technical accuracy over time because it's an extra step to remember to open a docs PR in another repo. Identified benefits - aster iteration on antsibull-docs updates, ability to split the core from community docs, and lead toward full community control over the documentation (samccann, 15:32:07) * Getting Started guide revamp (samccann, 15:41:14) * LINK: https://github.com/ansible/ansible-documentation/pull/14 (samccann, 15:41:44) * LINK: https://github.com/ansible-community/community-team/issues/243#issuecomment-1588912447 (samccann, 15:42:38) * EE content that is being discussed is here - https://github.com/ansible/community-docs/tree/main/execution_environments (samccann, 15:43:00) * LINK: https://docs.ansible.com/ansible/latest/getting_started/index.html (samccann, 15:43:39) * LINK: https://github.com/ansible/community-docs/tree/main/execution_environments (samccann, 16:00:43) * AGREED: The EE content (overview and getting started) should be its own guide in the Getting started navigation area on docs.asible.com (samccann, 16:12:36) * Open Floor (samccann, 16:12:52) Meeting ended at 16:13:53 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * samccann (103) * oranod (56) * acozine (26) * zodbot (11) * felixfontein (9) * TVo[m] (2) * gwmngilfen-work (2) * sutapa_bhattacha (1) * TVo (0) * Don (0) * Naro (0) * sutapa_bhattacharjee (0) Generated by `MeetBot`_ 0.4 .. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions