#ansible-docs: Documentation Working Group aka DaWGs
Meeting started by samccann at 16:01:01 UTC
(full logs).
Meeting summary
- Opening Chatter (samccann, 16:01:15)
- Action Item review (samccann, 16:04:51)
- 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)
- 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)
- https://github.com/ansible/ansible/issues/75508
(samccann,
16:27:59)
- 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)
- 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)
- 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)
- https://paste.debian.net/1218821/
<= ansible-doc -t filter ternary (bcoca,
16:55:37)
Meeting ended at 17:00:00 UTC
(full logs).
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
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.