====================================================
#ansible-docs: Documentation Working Group aka DaWGs
====================================================


Meeting started by samccann at 15:59:01 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2022-02-15/documentation_working_group_aka_dawgs.2022-02-15-15.59.log.html
.



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)
  * LINK:
    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)
  * LINK: 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)
  * LINK:
    https://github.com/ansible-collections/community.general/pull/4203
    <= example documenting filter that is in 'multifilter file'  (bcoca,
    16:58:40)
  * LINK: https://github.com/ansible-collections/community.general <=
    example documenting filter that is in single file  (bcoca, 16:58:56)
  * LINK:
    https://github.com/ansible-collections/community.general/pull/4202
    sorr, that one  (bcoca, 16:59:12)

Meeting ended at 17:03:00 UTC.




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
* **UNASSIGNED**
  * (none)




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

.. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions