Notification time stamped 2021-11-09 17:00:00 UTC
====================================================
#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_w...
.
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-418649f5e87f1496...
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+i...
(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
https://meetbot.fedoraproject.org/ansible-docs/2021-11-09/documentation_w...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...