#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. Action Item updates: (samccann, 16:05:13)
   
2. docs landing pages (samccann, 16:06:10)
   1. the community team has put together a first set of user journeys based on the personas, which are available at https://github.com/ansible/docsite/blob/personas/user-journeys/ansible-user-journey-maps.md (oranod, 16:07:30)
   2. we'd love to get review and feedback / whatever input folks in the community have got (oranod, 16:07:54)
   3. we're using these journeys to build a new docsite that will replace docs.ansible.com in a few weeks. you can find the work in progress site (and send a PR to help) here: https://github.com/ansible/jinja-docsite (oranod, 16:08:46)
   4. you can see the WIP docsite at -https://ansible.github.io/jinja-docsite/ (samccann, 16:09:49)
   5. docsite should help experienced users find things quickly like precidence list, jinja2 help etc (samccann, 16:15:16)
   6. folks can add feedback to https://github.com/ansible-community/community-topics/issues/175 (oranod, 16:17:10)
   7. we need some help fleshing out the WIP pages - feel free to grab one of the issues here and start hacking: https://github.com/ansible/jinja-docsite/issues (samccann, 16:21:47)
   8. these are based on the journeys defined in https://github.com/ansible/docsite/blob/personas/user-journeys/ansible-user-journey-maps.md (samccann, 16:22:03)
   9. ACTION: all - open issues on https://github.com/ansible/jinja-docsite/issues for your feedback on the current design at https://ansible.github.io/jinja-docsite/ (samccann, 16:23:43)
   10. ACTION: samccann to review top page hits and add to https://github.com/ansible/jinja-docsite/issues/35 as potential quicklinks (samccann, 16:29:41)
   11. https://www.lilatomic.ca/posts/ansible_httpapi_plugins/ <= has some VERY good plugin dev articles (bcoca, 16:33:33)
   
   
3. linking to external useful content for learners (samccann, 16:35:01)
   1. where could we use/highlight good external content like https://www.lilatomic.ca/posts/ansible_httpapi_plugins/ (samccann, 16:35:26)
   
   
4. Open Floor (samccann, 16:49:40)
   1. everyone who hasn't yet, please don't forget to participate in the vote for semantic markup (https://github.com/ansible-community/community-topics/discussions/205) and/or the vote for what kind of mechanism to use for private plugins in collections (https://github.com/ansible-community/community-topics/discussions/204) (oranod, 16:53:52)
   2. voting started for the community planning strategy - https://github.com/ansible-community/community-topics/issues/201#issuecomment-1458480432 (samccann, 16:57:31)

Action items

1. all - open issues on https://github.com/ansible/jinja-docsite/issues for your feedback on the current design at https://ansible.github.io/jinja-docsite/
2. samccann to review top page hits and add to https://github.com/ansible/jinja-docsite/issues/35 as potential quicklinks

Action items, by person

1. samccann
   1. samccann to review top page hits and add to https://github.com/ansible/jinja-docsite/issues/35 as potential quicklinks

People present (lines said)

1. samccann (84)
2. oranod (28)
3. acozine (23)
4. kristianheljas (15)
5. gwmngilfen-work (10)
6. zodbot (9)
7. tremble (9)
8. bcoca (7)
9. briantist (1)
10. Don (0)
11. Naro (0)
12. Gwmngilfen (0)