====================================================
#ansible-docs: Documentation Working Group aka DaWGs
====================================================


Meeting started by acozine at 15:01:12 UTC. The full logs are available
at ansible-docs/2021/ansible-docs.2021-08-31-15.01.log.html .



Meeting summary
---------------
* opening chatter  (acozine, 15:01:18)
  * IDEA: ... what does the idea hashtag do in the meeting minutes???
    (samccann, 15:01:56)

* action item review  (acozine, 15:05:59)
  * details on attributes - https://hackmd.io/R71WLQjPQOa-Ze0Cg97V7A
    and PR - https://github.com/ansible/ansible/pull/75563  (samccann,
    15:10:37)
  * ACTION: samccann to test out
    https://github.com/ansible/ansible/pull/75563 to see how it looks
    (samccann, 15:11:05)
  * expand/collapse on the ansible theme has some suggestions at
    https://github.com/ansible-community/antsibull/pull/303#issuecomment-905391511
    (samccann, 15:11:40)
  * LINK:
    https://sphinx-design.readthedocs.io/en/furo-theme/dropdowns.html
    looks pretty nice;
    https://sphinx-toolbox.readthedocs.io/en/stable/extensions/collapse.html#directive-collapse
    would need some CSS  (felixfontein, 15:11:40)
  * ACTION: samccann to test out the expand/collapse extensions listed
    in
    https://github.com/ansible-community/antsibull/pull/303#issuecomment-905391511
    to see how they display  (samccann, 15:18:58)
  * LINK:
    https://github.com/ansible-community/community-topics/issues/39
    (felixfontein, 15:20:41)
  * LINK:
    https://github.com/ansible-community/community-topics/issues/39#issuecomment-906133762
    (samccann, 15:20:45)
  * we were able to update CI to use Sphinx 3.5.4 but Sphinx 4.x
    generates errors  (acozine, 15:26:14)
  * on Sphinx 4.x we get the `1 validation error for
    ModuleDocSchema\ndoc -> attributes\n  extra fields not permitted `
    warnings   (acozine, 15:27:05)
  * LINK:
    https://www.irccloud.com/pastebin/eIT0SdYX/Sphinx%204%20error%20messages
    (acozine, 15:29:08)
  * ACTION: acozine to test Sphinx upgrade in CI for the devel branch
    (acozine, 15:38:43)
  * ACTION: samccann to discuss docs backport merging with core folks
    (samccann, 15:50:55)

* open floor  (acozine, 15:51:21)

Meeting ended at 16:08:31 UTC.




Action Items
------------
* samccann to test out https://github.com/ansible/ansible/pull/75563 to
  see how it looks
* samccann to test out the expand/collapse extensions listed in
  https://github.com/ansible-community/antsibull/pull/303#issuecomment-905391511
  to see how they display
* acozine to test Sphinx upgrade in CI for the devel branch
* samccann to discuss docs backport merging with core folks




Action Items, by person
-----------------------
* acozine
  * acozine to test Sphinx upgrade in CI for the devel branch
* samccann
  * samccann to test out https://github.com/ansible/ansible/pull/75563
    to see how it looks
  * samccann to test out the expand/collapse extensions listed in
    https://github.com/ansible-community/antsibull/pull/303#issuecomment-905391511
    to see how they display
  * samccann to discuss docs backport merging with core folks
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* acozine (108)
* samccann (57)
* felixfontein (39)
* abadger1999 (15)
* gwmngilfen-work (13)
* zodbot (12)
* gundalow (3)
* Xaroth (3)
* tadeboro (1)
* briantist (1)
* ariordan (1)




Generated by `MeetBot`_ 0.3

.. _`MeetBot`: http://wiki.debian.org/MeetBot