#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by oranod at 15:00:08 UTC (full logs).

Meeting summary

  1. documentation work (oranod, 15:01:19)
    1. https://github.com/ansible-community/community-topics/issues/243 (oranod, 15:02:21)
    2. we've agreed on July 10th as the date for the split from ansible/ansible to ansible/ansible-documentation (oranod, 15:02:58)
    3. after the split occurs all docs and example directories will no longer be present in ansible/ansible (this PR: https://github.com/ansible/ansible/pull/81011) (oranod, 15:04:08)
    4. currently working my way through the to do checklist here: https://hackmd.io/@ansible-community/rkzSKCEvh#To-do-before-split (oranod, 15:04:39)
    5. https://github.com/ansible/ansible-documentation/issues/36 (oranod, 15:06:27)
    6. samccann and I have spoken to the core team. I put down some details about how we can reduce contributor overhead. samccann and some of the core folks agreed on an approach to track doc items using a project board (oranod, 15:07:30)
    7. samccann can get into the nitty gritty details next week but I think it's safe to say we've been discussing the concerns and - fingers crossed - we should be alright. personally I have zero concerns with losing any sort of technical stewardship from core. (oranod, 15:09:40)

  2. docsite updates (oranod, 15:16:59)
    1. I opened a PR to remove the oldsite toggle from the landing pages on docs.ansible.com (oranod, 15:17:49)
    2. https://github.com/ansible/jinja-docsite/pull/122 (oranod, 15:18:04)

  3. Getting Started updates (oranod, 15:20:05)
    1. last week we got a PR merged to simplify getting started to focus a bit more on projects with a single dir structure (oranod, 15:21:29)
    2. https://github.com/ansible/ansible-documentation/pull/29 (oranod, 15:21:44)
    3. https://docs.ansible.com/ansible/devel/getting_started/index.html (oranod, 15:22:12)
    4. you can see the changes on devel now (oranod, 15:22:23)
    5. there is also an ongoing discussion around adding EE docs to getting started (oranod, 15:23:07)
    6. https://github.com/ansible/ansible-documentation/pull/18 (oranod, 15:23:10)
    7. I've been thinking about it some more and am going to propose that we create an ansible/ecosystem-documentation project where we can document tutorials and how tos for Ansible projects (oranod, 15:24:30)
    8. pretty much just the details here: https://github.com/ansible/ansible-documentation/pull/18#discussion_r1250599233 (oranod, 15:24:56)
    9. I hope this would help us avoid repeating a similar mistake with ramming too much content into a single doc set (oranod, 15:26:26)

  4. Open Floor (oranod, 15:30:12)


Meeting ended at 15:34:15 UTC (full logs).

Action items

  1. (none)


People present (lines said)

  1. oranod (49)
  2. zodbot (6)
  3. sutapa_bhattacha (5)
  4. anwesha[m] (1)
  5. sutapa_bhattacharjee (0)
  6. anwesha (0)


Generated by MeetBot 0.4.