==================================================== #ansible-docs: Documentation Working Group aka DaWGs ==================================================== Meeting started by samccann at 16:01:01 UTC. The full logs are available at https://meetbot.fedoraproject.org/ansible-docs/2021-11-09/documentation_working_group_aka_dawgs.2021-11-09-16.01.log.html . Meeting summary --------------- * Opening Chatter (samccann, 16:01:15) * Action Item review (samccann, 16:04:51) * LINK: https://github.com/ansible/community/issues/579#issuecomment-957950690 (samccann, 16:05:16) * core-2.12 docs including japanese translation are all published and done! (samccann, 16:05:37) * expand/collapse - (samccann, 16:08:19) * LINK: https://github.com/ansible/ansible/pull/75695/files#diff-418649f5e87f149692d365924e50aeae9f5d28cf2d165c451e3829d107614e81R14 says that sphinx 4.0.2 works fine? (felixfontein, 16:11:38) * ACTION: samccann to confirm expand/collapse PR is correctly setting CI to use sphinx 3 with matt clay (samccann, 16:14:50) * ACTION: samccann ariordan - expermiment with styling of the expand/collapse bar to make it more visually obvious (samccann, 16:20:15) * ACTION: samccann to experiment to see if we can set known-good version of sphinx back to 3.0 (samccann, 16:20:35) * ACTION: samccann to follow up with matt clay and gundalow on how to get sphinx up to 4.x in CI (samccann, 16:25:38) * docs survey issues (samccann, 16:27:12) * we need some help fixing the issues readers told us about in the last survey (samccann, 16:27:27) * LINK: https://github.com/ansible/ansible/issues/75508 (samccann, 16:27:59) * LINK: https://github.com/ansible/ansible/issues?q=is%3Aopen+is%3Aissue+survey+in%3Atitle (acozine, 16:28:02) * ACTION: acozine to draft some ideas on when to convert playbook to role for #75508 (samccann, 16:29:58) * ACTION: acozine to make a list of all the pages that use hosts: all for issue #75506 (samccann, 16:32:26) * reviving semantic markup (samccann, 16:33:33) * ACTION: samccann to revive Red Hat conversation on semantic markup and impact on ansible-docs and galaxy-ng/AH etc (samccann, 16:36:38) * there's already a PR for antsibull and ansible-doc, so it's mostly things like galaxy-ng/AH, ansible-navigator (in case it formats docs?), and maybe other tools that format docs missing (samccann, 16:38:46) * community-contributed examples (samccann, 16:39:31) * LINK: https://github.com/ansible-community/community-topics/issues/39 (samccann, 16:39:34) * ansible-navigator does its own docs construction so also needs to review semantic markup for any potential impacts (samccann, 16:42:21) * ACTION: all - review https://github.com/ansible-community/community-topics/issues/39 for community contributed examples and let's make some progress on this at our next meeting (samccann, 16:43:09) * network/cloud collections also use their own docs generator to render rst files within their collection repos (samccann, 16:44:36) * Open Floor (samccann, 16:50:39) * LINK: https://github.com/ansible/ansible/pull/74963 <= planning on taking it up back next week, also planning to document jinja2 filters/tests in core (bcoca, 16:51:40) * sidecar docs pr https://github.com/ansible/ansible/pull/74963 (samccann, 16:53:15) * jinja2 filters/tests docs coming as well (samccann, 16:53:47) * LINK: https://paste.debian.net/1218821/ <= ansible-doc -t filter ternary (bcoca, 16:55:37) Meeting ended at 17:00:00 UTC. Action Items ------------ * samccann to confirm expand/collapse PR is correctly setting CI to use sphinx 3 with matt clay * samccann ariordan - expermiment with styling of the expand/collapse bar to make it more visually obvious * samccann to experiment to see if we can set known-good version of sphinx back to 3.0 * samccann to follow up with matt clay and gundalow on how to get sphinx up to 4.x in CI * acozine to draft some ideas on when to convert playbook to role for #75508 * acozine to make a list of all the pages that use hosts: all for issue #75506 * samccann to revive Red Hat conversation on semantic markup and impact on ansible-docs and galaxy-ng/AH etc * all - review https://github.com/ansible-community/community-topics/issues/39 for community contributed examples and let's make some progress on this at our next meeting Action Items, by person ----------------------- * acozine * acozine to draft some ideas on when to convert playbook to role for #75508 * acozine to make a list of all the pages that use hosts: all for issue #75506 * ariordan * samccann ariordan - expermiment with styling of the expand/collapse bar to make it more visually obvious * gundalow * samccann to follow up with matt clay and gundalow on how to get sphinx up to 4.x in CI * samccann * samccann to confirm expand/collapse PR is correctly setting CI to use sphinx 3 with matt clay * samccann ariordan - expermiment with styling of the expand/collapse bar to make it more visually obvious * samccann to experiment to see if we can set known-good version of sphinx back to 3.0 * samccann to follow up with matt clay and gundalow on how to get sphinx up to 4.x in CI * samccann to revive Red Hat conversation on semantic markup and impact on ansible-docs and galaxy-ng/AH etc * **UNASSIGNED** * all - review https://github.com/ansible-community/community-topics/issues/39 for community contributed examples and let's make some progress on this at our next meeting People Present (lines said) --------------------------- * samccann (93) * acozine (41) * bcoca (20) * felixfontein (17) * zodbot (10) * ariordan (3) * remindbot[m] (3) * gundalow (1) * briantist (1) Generated by `MeetBot`_ 0.3 .. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions