#ansible-docs: Documentation Working Group aka DaWGs
Meeting started by samccann at 16:02:28 UTC
(full logs).
Meeting summary
-
- the devel docsite should have semantic markup
support from tomorrow on
(https://github.com/ansible/ansible/pull/80201), and the Ansible 7
docsite will also support it (felixfontein,
16:05:29)
- ansible-doc from ansible-core devel also
supports semantic markup
(https://github.com/ansible/ansible/pull/80242/files), and thus
ansible-doc from ansible-core 2.15 / Ansible 7 will also do
so (felixfontein,
16:05:53)
- https://github.com/ansible/ansible/pull/80212
and https://github.com/ansible/ansible/pull/80244 are required for
2.15 for semantic markup (samccann,
16:10:22)
- https://github.com/ansible/ansible/pull/80243
may not happen in time for 2.15 for semantic markup support
(samccann,
16:10:44)
- New docsite pages (samccann, 16:14:16)
- new docsite pages are visible at
https://ansible.github.io/jinja-docsite/ - please play aorund and
give us feedback (samccann,
16:14:37)
- please consider the Ansible docsite journeys
when reviewing the prototype docsite and be aware that the layout
and UX for the new docsite will change after we come to a decision
on the static site generator (oranod,
16:15:56)
- user journeys are here:
https://github.com/ansible/docsite/blob/personas/user-journeys/ansible-user-journey-maps.md
(oranod,
16:16:21)
- I could def use some extra review on the JS I'm
using for A/B testing
https://github.com/ansible/jinja-docsite/issues/20 (oranod,
16:19:01)
- once we have MVP issues fixed we can bring in
more reviewers to the docsite prototype before it goes live
(samccann,
16:21:02)
- help needed on some issues on that new docsite
- https://github.com/ansible/jinja-docsite/issues (samccann,
16:22:02)
- use the prototype website to explore the
user/contributor/developer journeys presented there. This is our
first iteration of changing how our readers explore ansible
docs (samccann,
16:23:04)
- we've identified a set of requirements and
potential candidates for the static site generator that we'll use to
build a new Ansible community website (after the vote closes) as
well as the new docsite. details are here:
https://github.com/ansible-community/community-topics/issues/210
(oranod,
16:24:32)
- Open Floor (samccann, 16:45:28)
- vote on the forum topic -
https://github.com/ansible-community/community-topics/discussions/211
(samccann,
16:46:18)
- https://github.com/pawamoy/best-of-mkdocs
(zbr,
16:49:51)
Meeting ended at 16:56:13 UTC
(full logs).
Action items
- (none)
People present (lines said)
- samccann (61)
- oranod (34)
- zbr (26)
- felixfontein (24)
- zodbot (6)
- briantist (3)
- ariordan (1)
- Don (0)
- Naro (0)
Generated by MeetBot 0.4.