#ansible-docs: Documentation Working Group aka DaWGs
Meeting started by samccann at 15:59:01 UTC
(full logs).
Meeting summary
- opening chatter (samccann, 15:59:11)
- Documentation updates (samccann, 16:03:12)
- looking for ways to expand this group and get
more docs contributions. Ideas welcome! (samccann,
16:03:49)
- - should be be more async? How do we do async
other than community-topics for things that need broad
discussion? (samccann,
16:04:10)
- ACTION: samccann to
investigate an instruqt tutorial on contributing to docs
(samccann,
16:22:16)
- - 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)
- Publishing non-versioned docs on a versioned docsite (samccann, 16:24:36)
- 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)
- https://docs.ansible.com/ansible/latest/porting_guides/porting_guides.html
(samccann,
16:26:33)
- 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)
- ACTION: samccann to
open community-topic to debate community guides on devel only or
regular backports to latest etc (samccann,
16:35:20)
- 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)
- Doctools updates (samccann, 16:35:47)
- adding extra links to collection and module
docs pages -
https://github.com/ansible-community/antsibull/pull/355 (samccann,
16:35:57)
- to see this in action -
https://ansible.fontein.de/collections/community/dns/ (samccann,
16:37:45)
- Improve attributes table PR -
https://github.com/ansible-community/antsibull/pull/401 looks
good! (samccann,
16:38:49)
- https://github.com/ansible-community/antsibull/pull/355
(acozine,
16:41:18)
- open Floor (samccann, 16:43:26)
- 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)
- https://github.com/ansible-collections/community.general/pull/4203
<= example documenting filter that is in 'multifilter file' (bcoca,
16:58:40)
- https://github.com/ansible-collections/community.general
<= example documenting filter that is in single file (bcoca,
16:58:56)
- 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
- samccann to investigate an instruqt tutorial on contributing to docs
- samccann to open community-topic to debate community guides on devel only or regular backports to latest etc
- 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
- samccann
- samccann to investigate an instruqt tutorial on contributing to docs
- samccann to open community-topic to debate community guides on devel only or regular backports to latest etc
- 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)
- samccann (105)
- acozine (67)
- bcoca (14)
- gwmngilfen-work (13)
- zodbot (9)
- briantist (5)
- remindbot[m] (3)
- Gwmngilfen (0)
Generated by MeetBot 0.4.