#ansible-docs: Documentation Working Group aka DaWGs

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)

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)