#ansible-docs: Documentation Working Group aka DaWGs
Meeting started by gundalow at 16:04:10 UTC
(full logs).
Meeting summary
- opening chatter (gundalow, 16:04:45)
- Agenda
https://github.com/ansible/community/issues/643#issuecomment-1021482151
(gundalow,
16:06:38)
- Documentation updates (gundalow, 16:07:35)
- 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)
- https://github.com/ansible/ansible/pull/49190
is where the work was done originally (gundalow,
16:12:02)
- 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)
- ACTION: samccann to
book time with search expert to help us reduce search results to
ancient docs (samccann[m],
16:37:30)
- ACTION: samccann
gunalow - get his cannonical url for 2.3 work staged on test
etc (samccann[m],
16:37:49)
- ACTION: gundalow to
look if redirects are broken (gundalow,
16:39:15)
- ACTION: samccann to
test https://github.com/ansible/ansible/pull/76759 for the updated
antsibull release (samccann[m],
16:41:53)
- https://github.com/ansible-community/antsibull/issues/386
(felixfontein,
16:43:31)
- 0.40.1 -> 0.40.2 fixes broken HTML -
https://github.com/ansible-community/antsibull/issues/386
(samccann[m],
16:44:19)
- 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)
- 0.40 to 0.40.1 -
https://github.com/ansible-community/antsibull/releases/tag/0.40.1
(samccann[m],
16:45:04)
- https://github.com/ansible/ansible/pull/76675
(samccann[m],
16:45:39)
- 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)
- 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
- samccann to book time with search expert to help us reduce search results to ancient docs
- samccann gunalow - get his cannonical url for 2.3 work staged on test etc
- gundalow to look if redirects are broken
- samccann to test https://github.com/ansible/ansible/pull/76759 for the updated antsibull release
Action items, by person
- gundalow
- gundalow to look if redirects are broken
- samccann
- samccann to book time with search expert to help us reduce search results to ancient docs
- samccann gunalow - get his cannonical url for 2.3 work staged on test etc
- samccann to test https://github.com/ansible/ansible/pull/76759 for the updated antsibull release
People present (lines said)
- samccann[m] (63)
- acozine (40)
- gundalow (33)
- felixfontein (20)
- zodbot (8)
- briantist (8)
- gwmngilfen-work (3)
- remindbot[m] (3)
- lmodemal[m] (2)
- lmodemal (0)
- samccann (0)
Generated by MeetBot 0.4.