#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 16:02:28 UTC (full logs).

Meeting summary

    1. 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)
    2. 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)
    3. 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)
    4. https://github.com/ansible/ansible/pull/80243 may not happen in time for 2.15 for semantic markup support (samccann, 16:10:44)

  1. New docsite pages (samccann, 16:14:16)
    1. new docsite pages are visible at https://ansible.github.io/jinja-docsite/ - please play aorund and give us feedback (samccann, 16:14:37)
    2. 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)
    3. user journeys are here: https://github.com/ansible/docsite/blob/personas/user-journeys/ansible-user-journey-maps.md (oranod, 16:16:21)
    4. 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)
    5. once we have MVP issues fixed we can bring in more reviewers to the docsite prototype before it goes live (samccann, 16:21:02)
    6. help needed on some issues on that new docsite - https://github.com/ansible/jinja-docsite/issues (samccann, 16:22:02)
    7. 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)
    8. 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)

  2. Open Floor (samccann, 16:45:28)
    1. vote on the forum topic - https://github.com/ansible-community/community-topics/discussions/211 (samccann, 16:46:18)
    2. https://github.com/pawamoy/best-of-mkdocs (zbr, 16:49:51)


Meeting ended at 16:56:13 UTC (full logs).

Action items

  1. (none)


People present (lines said)

  1. samccann (61)
  2. oranod (34)
  3. zbr (26)
  4. felixfontein (24)
  5. zodbot (6)
  6. briantist (3)
  7. ariordan (1)
  8. Don (0)
  9. Naro (0)


Generated by MeetBot 0.4.