#ansible-docs: Docs Working Group aka DaWGs

Meeting started by acozine at 15:01:08 UTC (full logs).

Meeting summary

  1. opening chatter (acozine, 15:01:13)
    1. ansible-core 2.11 was released yesterday (April 26) (acozine, 15:08:04)
    2. Ansible 2.9.21rc1 and 2.10.9rc1 are being cut today (acozine, 15:08:35)
    3. last week's DaWGs Mini Docs PR Day reviewed and merged or close 12 PRs, thanks to all who participated! (acozine, 15:09:17)
    4. core docs are now at https://docs.ansible.com/ansible-core/devel/index.html (samccann, 15:10:19)

  2. versions and maintenance (acozine, 15:16:05)
    1. version-switcher for /ansible/ docs now only shows `devel`, `latest` (which is 3) and `2.9` (acozine, 15:16:31)
    2. once Ansible 4 releases, it will become `latest` and Ansibl 3 docs will be EOL (samccann, 15:16:48)
    3. if a maintenance team steps forward for Ansible 3, we can add `3` to the mix, but maintainers will need to maintain docs (with backports) as well as code (acozine, 15:17:23)

  3. Sphinx upgrade (acozine, 15:19:35)
    1. WIP PR to upgrade the Sphinx version is open: https://github.com/ansible/ansible/pull/74372 (acozine, 15:21:43)
    2. if any folks have spare time this week, please test the latest Sphinx version with our docs (acozine, 15:26:17)
    3. https://www.sphinx-doc.org/en/master/ (acozine, 15:30:55)
    4. AGREED: we'd rather risk breakages with updates to Sphinx than face the problems of pinning to a known older version (acozine, 15:32:24)
    5. Sphinx has a channel called sphinx-doc here on freenode IRC, maybe one of the DaWGs can join that and keep tabs on upcoming changes (acozine, 15:34:16)

  4. ansible Sphinx theme (acozine, 15:34:30)
    1. WIP PR: https://github.com/ansible/ansible/pull/74318 (acozine, 15:35:07)
    2. the ansible theme is pretty close to what we need, but have some requests in for changes to match our current look and feel and to support ansible-core docs with theme changes (samccann, 15:36:33)
    3. ACTION: samccann to test sphinx 4.x beta as it has 'breaking changes' warning on it (samccann, 15:38:51)
    4. theme changes for `ansible-core` introduced in https://github.com/ansible/ansible/pull/74356; current ansible-core docs are published as https://docs.ansible.com/ansible-core/devel/ (acozine, 15:39:25)
    5. core theme changes support a different look so readers know they are not on the Ansible (package) docsite (samccann, 15:40:49)

  5. searching and sitemaps for the `ansible-core` docs (acozine, 15:41:36)
    1. https://packages.gentoo.org/packages/search?q=ansible (tadeboro, 15:59:30)
    2. need to keep this discussion open - what are the distros doing with ansible vs ansible core etc. Gentoo seems to have both for example (samccann, 16:02:58)

  6. open floor (acozine, 16:03:28)


Meeting ended at 16:08:10 UTC (full logs).

Action items

  1. samccann to test sphinx 4.x beta as it has 'breaking changes' warning on it


Action items, by person

  1. samccann
    1. samccann to test sphinx 4.x beta as it has 'breaking changes' warning on it


People present (lines said)

  1. acozine (123)
  2. samccann (65)
  3. tadeboro (16)
  4. bcoca (15)
  5. zodbot (7)
  6. relrod (2)
  7. felixfontein (1)


Generated by MeetBot 0.1.4.