documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

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

Meeting summary

  1. opening chatter (samccann, 15:59:11)
  2. Documentation updates (samccann, 16:03:12)
    1. looking for ways to expand this group and get more docs contributions. Ideas welcome! (samccann, 16:03:49)
    2. - should be be more async? How do we do async other than community-topics for things that need broad discussion? (samccann, 16:04:10)
    3. ACTION: samccann to investigate an instruqt tutorial on contributing to docs (samccann, 16:22:16)
    4. - collection maintainers guide PR - https://docs.ansible.com/ansible/devel/index.html - hope to merge soon and then stub out the same content on community-docs repo. (samccann, 16:22:58)

  3. Publishing non-versioned docs on a versioned docsite (samccann, 16:24:36)
    1. we have multiple pages on docs.ansible.com that are not tied to the core or Ansible release. Today, we publish them only to devel but this confused at least one person recently (samccann, 16:25:06)
    2. https://docs.ansible.com/ansible/latest/porting_guides/porting_guides.html (samccann, 16:26:33)
    3. we did this devel-only publishing because PRs weren't being backported so latest frequently had stale info, and most of these are not version-specific anyway (samccann, 16:28:51)
    4. ACTION: samccann to open community-topic to debate community guides on devel only or regular backports to latest etc (samccann, 16:35:20)
    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, 16:35:33)

  4. Doctools updates (samccann, 16:35:47)
    1. adding extra links to collection and module docs pages - https://github.com/ansible-community/antsibull/pull/355 (samccann, 16:35:57)
    2. to see this in action - https://ansible.fontein.de/collections/community/dns/ (samccann, 16:37:45)
    3. Improve attributes table PR - https://github.com/ansible-community/antsibull/pull/401 looks good! (samccann, 16:38:49)
    4. https://github.com/ansible-community/antsibull/pull/355 (acozine, 16:41:18)

  5. open Floor (samccann, 16:43:26)
    1. ACTION: samccann to followup with community team on best ways to give shout outs to new contributors and those in top 10 so to speak (samccann, 16:54:36)
    2. https://github.com/ansible-collections/community.general/pull/4203 <= example documenting filter that is in 'multifilter file' (bcoca, 16:58:40)
    3. https://github.com/ansible-collections/community.general <= example documenting filter that is in single file (bcoca, 16:58:56)
    4. https://github.com/ansible-collections/community.general/pull/4202 sorr, that one (bcoca, 16:59:12)


Meeting ended at 17:03:00 UTC (full logs).

Action items

  1. samccann to investigate an instruqt tutorial on contributing to docs
  2. samccann to open community-topic to debate community guides on devel only or regular backports to latest etc
  3. samccann to followup with community team on best ways to give shout outs to new contributors and those in top 10 so to speak


Action items, by person

  1. samccann
    1. samccann to investigate an instruqt tutorial on contributing to docs
    2. samccann to open community-topic to debate community guides on devel only or regular backports to latest etc
    3. samccann to followup with community team on best ways to give shout outs to new contributors and those in top 10 so to speak


People present (lines said)

  1. samccann (105)
  2. acozine (67)
  3. bcoca (14)
  4. gwmngilfen-work (13)
  5. zodbot (9)
  6. briantist (5)
  7. remindbot[m] (3)
  8. Gwmngilfen (0)


Generated by MeetBot 0.4.