documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by gundalow at 16:04:10 UTC (full logs).

Meeting summary

  1. opening chatter (gundalow, 16:04:45)
    1. Agenda https://github.com/ansible/community/issues/643#issuecomment-1021482151 (gundalow, 16:06:38)

  2. Documentation updates (gundalow, 16:07:35)
    1. We've been looking at canonical url support to the Ansible 2.3 and 2.4 docs sites (as Google links to the old docs sometimes). To do this we'd need to backport the sphinx theme, which we've not looked into yet (gundalow, 16:09:43)
    2. https://github.com/ansible/ansible/pull/49190 is where the work was done originally (gundalow, 16:12:02)
    3. we still have problems with older docs coming up first in search results (eg google "ansible authorized_key" and you get 2.3 or 2.4 at the top results) (samccann[m], 16:19:27)
    4. ACTION: samccann to book time with search expert to help us reduce search results to ancient docs (samccann[m], 16:37:30)
    5. ACTION: samccann gunalow - get his cannonical url for 2.3 work staged on test etc (samccann[m], 16:37:49)
    6. ACTION: gundalow to look if redirects are broken (gundalow, 16:39:15)
    7. ACTION: samccann to test https://github.com/ansible/ansible/pull/76759 for the updated antsibull release (samccann[m], 16:41:53)
    8. https://github.com/ansible-community/antsibull/issues/386 (felixfontein, 16:43:31)
    9. 0.40.1 -> 0.40.2 fixes broken HTML - https://github.com/ansible-community/antsibull/issues/386 (samccann[m], 16:44:19)
    10. https://github.com/ansible-community/antsibull/releases/tag/0.40.1 says "Fix bug in collection enum for docs generation, which caused role FQCNs to be mangled (#379)." (felixfontein, 16:44:34)
    11. 0.40 to 0.40.1 - https://github.com/ansible-community/antsibull/releases/tag/0.40.1 (samccann[m], 16:45:04)
    12. https://github.com/ansible/ansible/pull/76675 (samccann[m], 16:45:39)
    13. looking for feedback - PR that closes 3 open issues, adding support for both more lenient, and more strict docs builds, and specifying a specific antsibull version (all helpful for expanding the scope of scenarios for building docs: https://github.com/ansible-community/github-docs-build/pull/27 (samccann[m], 16:48:16)
    14. also looking for feedback on a comment on an open issue with an idea of how to solve a tricky problem around the shared GitHub workflows referencing the actions in a consistent way (this is more in the weeds of GHA stuff, not so interesting around docs directly): https://github.com/ansible-community/github-docs-build/issues/4#issuecomment-1024974751 (samccann[m], 16:48:38)


Meeting ended at 16:58:20 UTC (full logs).

Action items

  1. samccann to book time with search expert to help us reduce search results to ancient docs
  2. samccann gunalow - get his cannonical url for 2.3 work staged on test etc
  3. gundalow to look if redirects are broken
  4. samccann to test https://github.com/ansible/ansible/pull/76759 for the updated antsibull release


Action items, by person

  1. gundalow
    1. gundalow to look if redirects are broken
  2. samccann
    1. samccann to book time with search expert to help us reduce search results to ancient docs
    2. samccann gunalow - get his cannonical url for 2.3 work staged on test etc
    3. samccann to test https://github.com/ansible/ansible/pull/76759 for the updated antsibull release


People present (lines said)

  1. samccann[m] (63)
  2. acozine (40)
  3. gundalow (33)
  4. felixfontein (20)
  5. zodbot (8)
  6. briantist (8)
  7. gwmngilfen-work (3)
  8. remindbot[m] (3)
  9. lmodemal[m] (2)
  10. lmodemal (0)
  11. samccann (0)


Generated by MeetBot 0.4.