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


Meeting started by acozine at 15:08:32 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-05-25/docs_working_group_aka_dawgs.2021-05-25-15.08.log.html
.



Meeting summary
---------------
* opening chatter  (acozine, 15:08:45)
  * we now have an #ansible-docs channel on irc.libera.chat  (acozine,
    15:09:56)
  * pending the community decision tomorrow, we may move to libera for
    next week's meeting. We will post details here when that decision is
    made  (samccann, 15:10:59)
  * LINK: https://libera.chat/guides/registration   (felixfontein,
    15:13:25)

* Jinja2 upgrade issue  (acozine, 15:15:07)
  * proposed plan for preventing dependency surprises: pin dependencies
    to latest known good versions in `docs/docsite/requirements.txt`,
    schedule quarterly reviews in DaWGs where we "unleash" the versions
    and fix any issues that come up  (acozine, 15:27:16)
  * and then pin to the new tested versions so we don't have a docs
    outage like we had last week  (samccann, 15:28:13)
  * Pros and cons of using the last tested version: Pro: We know that
    the docs won't start mysteriously failing for a reason unrelated to
    any updates we make. Con: System packagers and other people building
    docs in a controlled environment could have difficulty building the
    docs because they could be standardizing on a newer version than we
    have pinned.  (samccann, 15:38:21)
  * VOTE: revise previous proposal to implement a "two-file solution" so
    users can choose to install known-good versions or any version
    (samccann, 15:55:06)
  * AGREED: we will include both an unpinned `requirements.txt` file and
    a pinned `known-good-versions.txt` (exact name of the second file
    TBD) in `docs/docsite` for visibility and flexibility, then use the
    pinned file in Jenkins to avoid surprises  (acozine, 15:57:29)

* collection docs stuff  (acozine, 15:58:18)
  * breadcrumbs work is done, breadcrumbs are live on the site, and the
    build is creating them reliably  (acozine, 16:07:10)
  * collections "extra docs" will be added this week  (acozine,
    16:07:40)
  * AGREED: https://github.com/ansible-community/antsibull/pull/255 is
    ready to merge  (acozine, 16:07:51)

* open floor  (acozine, 16:08:22)

Meeting ended at 16:16:49 UTC.




Action Items
------------





Action Items, by person
-----------------------
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* acozine (115)
* samccann (44)
* felixfontein (32)
* abadger1999 (27)
* cyberpear (11)
* zodbot (10)
* lmodemal (4)
* dericcrago (1)
* gundalow (0)




Generated by `MeetBot`_ 0.1.4

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