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


Meeting started by acozine at 14:30:54 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-05-26/docs_working_group_aka_dawgs.2020-05-26-14.30.log.html
.



Meeting summary
---------------
* changelogs in a collections ecosystem  (acozine, 14:35:02)
  * LINK: https://github.com/ansible-collections/overview/issues/18 is
    the tracking issue  (acozine, 14:35:32)
  * implemented a `trivial` category (which isn't shown in the generated
    .rst file; useful if f.ex. a collection wants to have a changelog
    fragment with *every* PR  (samccann, 14:37:29)
  * felixfontein also  implemented support that you can use the tool
    when galaxy.yml isn't there (you'll have to provide more parameters
    via command-line arguments)  (samccann, 14:38:52)
  * this work is in  https://github.com/ansible-community/ansibulled now
    (samccann, 14:41:46)
  * documentation:
    https://github.com/ansible-community/ansibulled/blob/master/docs/changelogs.rst
    https://github.com/ansible-community/ansibulled/blob/master/docs/changelog.yaml-format.md
    (felixfontein, 14:42:13)
  * what's left to do on this - more people testing/using it - first get
    it on pypi for easy install, and settle on the naming convention for
    these tools  (samccann, 14:48:06)

* naming for the new docs build tool (and other related tools)
  (acozine, 14:48:39)
  * LINK:
    https://github.com/ansible-community/ansibulled/wiki/Naming-things-is-hard
    (abadger1999, 14:49:38)
  * LINK: https://github.com/willyg302/antsy   (felixfontein, 14:56:17)
  * LINK: https://github.com/adamkpickering/antsy-bull - A configuration
    management (and more) framework with all the benefits of Ansible and
    none of the drawbacks  (felixfontein, 15:04:07)
  * AGREED: we will use something like antsy-bull/antsibull - to be
    discussed/decided later  (samccann, 15:13:59)

* porting guides  (acozine, 15:15:01)
  * automating porting guide for 2.10 from changelog fragments is a
    stretch goal, but not committed to it yet. need to determine
    complexity of rst embedded in a changelog fragment etc  (samccann,
    15:35:51)
  * LINK: https://github.com/ansible/community/issues/539 in case anyone
    is interested  (felixfontein, 15:37:49)
  * ACTION: samccann to add 'what do we need to move issues/prs for
    docs' to thursday's agenda  (samccann, 15:43:50)
  * AGREED: we will have a supplemental DaWGs meeting at 10AM ET on
    Thursday this week  (samccann, 15:44:12)

* open floor  (acozine, 15:44:32)

Meeting ended at 15:49:26 UTC.




Action Items
------------
* samccann to add 'what do we need to move issues/prs for docs' to
  thursday's agenda




Action Items, by person
-----------------------
* samccann
  * samccann to add 'what do we need to move issues/prs for docs' to
    thursday's agenda
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* acozine (108)
* felixfontein (83)
* samccann (50)
* abadger1999 (41)
* briantist (13)
* zodbot (11)
* dmellado (10)
* gundalow (7)
* bcoca (4)
* Sayee (2)
* relrod (1)




Generated by `MeetBot`_ 0.1.4

.. _`MeetBot`: http://wiki.debian.org/MeetBot