==================================================== #ansible-docs: Documentation Working Group aka DaWGs ==================================================== Meeting started by samccann at 16:02:28 UTC. The full logs are available at https://meetbot.fedoraproject.org/ansible-docs/2023-03-21/documentation_working_group_aka_dawgs.2023-03-21-16.02.log.html . Meeting summary --------------- * the devel docsite should have semantic markup support from tomorrow on (https://github.com/ansible/ansible/pull/80201), and the Ansible 7 docsite will also support it (felixfontein, 16:05:29) * ansible-doc from ansible-core devel also supports semantic markup (https://github.com/ansible/ansible/pull/80242/files), and thus ansible-doc from ansible-core 2.15 / Ansible 7 will also do so (felixfontein, 16:05:53) * https://github.com/ansible/ansible/pull/80212 and https://github.com/ansible/ansible/pull/80244 are required for 2.15 for semantic markup (samccann, 16:10:22) * https://github.com/ansible/ansible/pull/80243 may not happen in time for 2.15 for semantic markup support (samccann, 16:10:44) * New docsite pages (samccann, 16:14:16) * new docsite pages are visible at https://ansible.github.io/jinja-docsite/ - please play aorund and give us feedback (samccann, 16:14:37) * please consider the Ansible docsite journeys when reviewing the prototype docsite and be aware that the layout and UX for the new docsite will change after we come to a decision on the static site generator (oranod, 16:15:56) * user journeys are here: https://github.com/ansible/docsite/blob/personas/user-journeys/ansible-user-journey-maps.md (oranod, 16:16:21) * I could def use some extra review on the JS I'm using for A/B testing https://github.com/ansible/jinja-docsite/issues/20 (oranod, 16:19:01) * once we have MVP issues fixed we can bring in more reviewers to the docsite prototype before it goes live (samccann, 16:21:02) * help needed on some issues on that new docsite - https://github.com/ansible/jinja-docsite/issues (samccann, 16:22:02) * use the prototype website to explore the user/contributor/developer journeys presented there. This is our first iteration of changing how our readers explore ansible docs (samccann, 16:23:04) * we've identified a set of requirements and potential candidates for the static site generator that we'll use to build a new Ansible community website (after the vote closes) as well as the new docsite. details are here: https://github.com/ansible-community/community-topics/issues/210 (oranod, 16:24:32) * Open Floor (samccann, 16:45:28) * vote on the forum topic - https://github.com/ansible-community/community-topics/discussions/211 (samccann, 16:46:18) * LINK: https://github.com/pawamoy/best-of-mkdocs (zbr, 16:49:51) Meeting ended at 16:56:13 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * samccann (61) * oranod (34) * zbr (26) * felixfontein (24) * zodbot (6) * briantist (3) * ariordan (1) * Don (0) * Naro (0) Generated by `MeetBot`_ 0.4 .. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions