documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 16:01:35 UTC (full logs).

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)


Meeting ended at 16:58:20 UTC (full logs).

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)


Generated by MeetBot 0.4.