documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 15:01:43 UTC (full logs).

Meeting summary

  1. opening chatter (samccann, 15:01:59)
  2. Explaining this meeting (samccann, 15:09:09)
  3. Documentation updates (samccann, 15:12:46)
    1. revamped getting started published! - https://docs.ansible.com/ansible/devel/getting_started/index.html (samccann, 15:12:55)
    2. need reviews of redirects for traffic from old location to new. It's a private github repo (boo) but see this pastbin https://github.com/ansible-community/github-docs-buil (samccann, 15:14:01)
    3. ACTION: samccann to get the new getting started guide in the bullhorn newsletter (samccann, 15:16:12)

  4. Ansible OS Docs on this week's Twitter Space! (samccann, 15:18:11)
    1. community-writers team is hosting a meeting on the Write the Docs NG twitter space this Friday, covering what is open source, docs, and how to use Ansible as an introduction to contributing to opensource projects (samccann, 15:20:55)
    2. https://twitter.com/NgDocs/status/1533785549806477312 (gundalow, 15:22:39)
    3. https://twitter.com/NgDocs/status/1533785549806477312 (samccann, 15:22:55)
    4. To participate in the Twitter Space live, log in with your Twitter account and join https://twitter.com/i/spaces/1mrGmarvpdLGy on June 17 at 19:30 WAT/UTC +1 (cybette_, 15:24:33)
    5. The recording will be available after the event for 30 days (cybette_, 15:25:10)

  5. Docs updates again (samccann, 15:25:51)
    1. Ansible 6 goes out in a week so we're staging docs etc in preparation. (samccann, 15:26:19)
    2. plan going forward is to keep latest and devel docs in sync (aka backports). Wish us luck! (samccann, 15:26:39)
    3. - if you need an editor to review docs PRs or do light editing (edit on github) we have a team of community writers willing to help. See https://github.com/orgs/ansible-community/projects/3/views/1?sortedBy%5Bdirection%5D=asc&sortedBy%5BcolumnId%5D=Status and ping us here if you need access to add your PRs/easyfix issues to that board. (samccann, 15:29:00)

  6. doctools (samccann, 15:29:55)
    1. does ansible/ansible CI only test the core docs? We now have multiple rst pages that only exist in Ansible package docs and I worry we aren't getting CI testing on them anymore. (samccann, 15:31:38)
    2. ACTION: samccann open a community-topic to discuss docs and CI and how to get CI testing on excluded (aka package only) docs (samccann, 15:33:59)
    3. might be time to update our requirements packages? sphinx/rstcheck are advancing, as is antsibull-docs, amongst others. (samccann, 15:34:21)

  7. OpenFloor (samccann, 15:36:36)
    1. https://github.com/orgs/ansible-community/projects/3/views/1?layout=board (gundalow, 15:42:10)


Meeting ended at 15:46:54 UTC (full logs).

Action items

  1. samccann to get the new getting started guide in the bullhorn newsletter
  2. samccann open a community-topic to discuss docs and CI and how to get CI testing on excluded (aka package only) docs


Action items, by person

  1. samccann
    1. samccann to get the new getting started guide in the bullhorn newsletter
    2. samccann open a community-topic to discuss docs and CI and how to get CI testing on excluded (aka package only) docs


People present (lines said)

  1. samccann (99)
  2. cybette_ (14)
  3. zodbot (8)
  4. gundalow (7)
  5. Dule_Martins0383 (2)
  6. Dule_Martins#0383 (0)
  7. cybette (0)


Generated by MeetBot 0.4.