#ansible-docs: Ansible Documentation Working Group

Meeting summary

1. 1. First meeting, will have a look at some PRs (gundalow, 14:32:03)
   2. my name is Alicia Cozine, I'm the lead tech writer for Ansible (acozine, 14:37:17)
   3. I am David F, I am on the Ansible BU Product Management team. (dfed, 14:37:17)
   4. I'm gundalow, I look after the Ansible Community (gundalow, 14:37:17)
   5. I'm Brian Coca and have been so.. er a core developer for ansible (bcoca, 14:37:17)
   6. my name is Jake Jackson, I am a senior product field engineer, working with the getting started team at Ansible (thedoubl3j, 14:37:18)
   7. I am Bianca H, I work on the Getting Started team as well, as Sr Product Field Engineer. (bizonk, 14:37:18)
   
   
2. PR review (gundalow, 14:37:18)
   1. Will go through some PRs to see what we can merge (gundalow, 14:39:38)
   2. https://github.com/ansible/ansible/pull/46504 RabbitMQ documentation suggests that deleting queues/exchanges is not implemented, but it is (gundalow, 14:39:38)
   3. https://github.com/ansible/ansible/blob/f3c05ccc37587530be1aa5271baad0af517efcda/lib/ansible/modules/messaging/rabbitmq_exchange.py#L203 (gundalow, 14:39:55)
   4. ACTION: gundalow to create backport (gundalow, 14:40:56)
   5. https://github.com/ansible/ansible/pull/46064 (acozine, 14:41:32)
   6. https://github.com/ansible/ansible/pull/46064 BOTMETA: Move rabbitmq modules to own directory (gundalow, 14:42:00)
   7. ACTION: acozine to rebase PR 46064 (acozine, 14:47:27)
   8. AGREED: rebase & merge BOTMETA: Move rabbitmq modules to own directory #46064 (gundalow, 14:47:38)
   9. ACTION: acozine to merge https://github.com/ansible/ansible/pull/47818 (2.7 backport) (gundalow, 14:48:43)
   10. https://github.com/ansible/ansible/pull/47816/files would change description of VLAN parameters (acozine, 14:48:58)
   11. ACTION: gundalow to backport https://github.com/ansible/ansible/pull/47816/files would change description of VLAN parameters (gundalow, 14:50:46)
   12. https://github.com/ansible/ansible/pull/47778 This adds a link so that contributors have an easier time finding additional information on PRs (bizonk, 14:51:28)
   
   
3. with_ vs loops docs (gundalow, 14:57:23)
   1. https://github.com/ansible/ansible/issues/47703#issuecomment-433946762 (gundalow, 15:06:06)
   2. `with_` syntax is not obsolete, and is not deprecated. (gundalow, 15:06:21)
   3. https://github.com/ansible/ansible/pull/47364#issuecomment-431472984 (gundalow, 15:09:13)
   4. when to, and when not to use `loop` https://github.com/ansible/ansible/pull/47364#issuecomment-431472984 (gundalow, 15:09:55)
   5. ACTION: acozine to update the playbooks_loops page with sivel's comments (acozine, 15:10:14)
   
   
4. PR review (gundalow, 15:12:04)
   1. https://gist.github.com/bcoca/b1f3d8d6e802663b0e818959b2d547e6 (bcoca, 15:17:08)
   
   
5. squeezing in a last PR review (acozine, 15:20:24)
   1. https://github.com/ansible/ansible/pull/47767 - updates the output shown for ansible facts from Ansible 1.4 to Ansible 2.7 (acozine, 15:21:08)
   2. https://github.com/ansible/ansible/pull/47664/files This is very sweet, but I think it's one to close (changes "Ansible is an IT automation tool" to "Ansible is an great IT automation tool" [sic]) (bizonk, 15:31:34)
   3. Agenda has been created https://github.com/ansible/community/issues/389 (gundalow, 15:35:15)
   4. ACTION: bizonk to alert Marketing about Docs PR 47664 (bizonk, 15:35:17)

Action items

1. gundalow to create backport
2. acozine to rebase PR 46064
3. acozine to merge https://github.com/ansible/ansible/pull/47818 (2.7 backport)
4. gundalow to backport https://github.com/ansible/ansible/pull/47816/files would change description of VLAN parameters
5. acozine to update the playbooks_loops page with sivel's comments
6. bizonk to alert Marketing about Docs PR 47664

Action items, by person

1. acozine
   1. acozine to rebase PR 46064
   2. acozine to merge https://github.com/ansible/ansible/pull/47818 (2.7 backport)
   3. acozine to update the playbooks_loops page with sivel's comments
2. bizonk
   1. bizonk to alert Marketing about Docs PR 47664
3. gundalow
   1. gundalow to create backport
   2. gundalow to backport https://github.com/ansible/ansible/pull/47816/files would change description of VLAN parameters
4. sivel
   1. acozine to update the playbooks_loops page with sivel's comments

People present (lines said)

1. acozine (71)
2. gundalow (62)
3. bizonk (28)
4. dfed (26)
5. theodubl3j (18)
6. zodbot (12)
7. bcoca (11)
8. samccann (9)
9. GreNME (8)
10. Xaroth (7)
11. felixfontein (4)
12. thedoubl3j (2)
13. akshay196 (1)
14. thedoubl3j_ (1)
15. sivel (1)