documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

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

Meeting summary

  1. opening chatter (samccann, 15:01:57)
  2. Documentation updates (samccann, 15:04:54)
    1. revamped getting started published! - https://docs.ansible.com/ansible/devel/getting_started/index.html (samccann, 15:05:28)
    2. need some reviews on these http redirects for the old getting started and quickstart guide pages - https://pastebin.com/iYCskNLD (samccann, 15:10:38)
    3. we have a set of redirects 2.9 <-> Ansible 3,4,5,(6). Do we need them around for Ansible 7 when 2.9 has already EOL'd? (samccann, 15:15:08)
    4. ACTION: samccann - test out bringing back redirects for pre -2.5 (https://github.com/ansible/docsite/pull/38/files) and if that works, open community-topic to discuss if we bring that back but lose redirects 2.9 <--> Ansible package docs (samccann, 15:33:49)
    5. Seems like our redirects are either pre-2.5, or 2.9 <--> Ansible package (to support version switcher) (samccann, 15:34:18)
    6. but 2.9 is EOL and no longer in version switcher so may not need those redirects anymore. (samccann, 15:34:34)

  3. Ansible community-writers (samccann, 15:35:29)
    1. we now have a batch of technical writers volunteering to help out with Ansible docs (across all projects) (samccann, 15:35:55)
    2. for now, this is limited to docs PR reviews and anything well-described in the issue that can be solved with Github Edit button. (samccann, 15:36:28)
    3. this is open to collection owners, any ansible-related project that needs help (samccann, 15:38:15)
    4. - 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:38:28)
    5. always looking for help on the backlog - issues - https://github.com/ansible/ansible/issues?q=is%3Aopen+is%3Aissue+label%3Adocs and PRs - https://github.com/ansible/ansible/pulls?q=is%3Aopen+is%3Apr+label%3Adocs (samccann, 15:39:13)

  4. doctools (samccann, 15:39:57)
    1. Do we want to add names to changlogs? See https://github.com/ansible/awx/releases/tag/21.1.0 (especially new contributors) (samccann, 15:40:10)
    2. ACTION: samccann to create issue to add to changelog fragment instructions that they should be written for end users unless the change is specific to a developer (samccann, 15:55:20)

  5. Open Floor (samccann, 15:55:31)


Meeting ended at 15:59:33 UTC (full logs).

Action items

  1. samccann - test out bringing back redirects for pre -2.5 (https://github.com/ansible/docsite/pull/38/files) and if that works, open community-topic to discuss if we bring that back but lose redirects 2.9 <--> Ansible package docs
  2. samccann to create issue to add to changelog fragment instructions that they should be written for end users unless the change is specific to a developer


Action items, by person

  1. samccann
    1. samccann - test out bringing back redirects for pre -2.5 (https://github.com/ansible/docsite/pull/38/files) and if that works, open community-topic to discuss if we bring that back but lose redirects 2.9 <--> Ansible package docs
    2. samccann to create issue to add to changelog fragment instructions that they should be written for end users unless the change is specific to a developer


People present (lines said)

  1. samccann (107)
  2. acozine (52)
  3. zodbot (9)
  4. briantist (2)
  5. tremble (2)
  6. orandon[m] (1)
  7. felixfontein (1)
  8. Don (0)
  9. Naro (0)


Generated by MeetBot 0.4.