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


Meeting started by acozine at 14:31:52 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-05-12/docs_working_group_aka_dawgs.2020-05-12-14.31.log.html
.



Meeting summary
---------------
* removing ansible_metadata  (acozine, 14:36:11)
  * collections tracking issue  -
    https://github.com/ansible-collections/overview/issues/57
    (samccann, 14:36:42)
  * ansible-base issue - https://github.com/ansible/ansible/pull/69454
    (samccann, 14:36:56)
  * ansible metdata has two fields, neither of which seem necessary in
    the new world order  (samccann, 14:37:27)
  * AGREED: move status field to an optional documentation section of
    each module and remove ANSIBLE_METADATA field entirely  (samccann,
    14:40:44)
  * AGREED: create a documentation field for status, default is NULL and
    will not show up in output (docs or Galaxy/AH). Developer set their
    preferred default in a doc_fragment (preview or stable).  (samccann,
    14:54:12)
  * ACTION: - need to test if a module status setting overrides the
    doc_fragment setting so an individual module could be preview if the
    doc_frag default is stable for example  (samccann, 14:55:49)
  * whatever we decide, galaxy, AH, docsite, and ansible-doc will have
    to change... and likely docs pipeline and doc generation changes too
    (samccann, 15:02:19)
  * LINK: https://github.com/ansible/proposals/issues/68
    (felixfontein, 15:13:45)
  * ACTION: - samccann to comment on
    https://github.com/ansible-collections/overview/issues/57 to drop
    status entirely and ask for feedback on bcoca proposal  (samccann,
    15:22:13)
  * LINK: https://github.com/ansible/proposals/issues/68   (samccann,
    15:22:42)
  * AGREED: ANSIBLE_METADATA gets dropped entirely, and no immediate
    replacement for STATUS  (samccann, 15:24:23)

* version_added  (acozine, 15:25:34)
  * AGREED: for new features in the module docs, `version_added` should
    refer to the collection version moving forward  (acozine, 15:43:48)

Meeting ended at 15:46:38 UTC.




Action Items
------------
* - need to test if a module status setting overrides the doc_fragment
  setting so an individual module could be preview if the doc_frag
  default is stable for example
* - samccann to comment on
  https://github.com/ansible-collections/overview/issues/57 to drop
  status entirely and ask for feedback on bcoca proposal




Action Items, by person
-----------------------
* bcoca
  * - samccann to comment on
    https://github.com/ansible-collections/overview/issues/57 to drop
    status entirely and ask for feedback on bcoca proposal
* samccann
  * - samccann to comment on
    https://github.com/ansible-collections/overview/issues/57 to drop
    status entirely and ask for feedback on bcoca proposal
* **UNASSIGNED**
  * - need to test if a module status setting overrides the doc_fragment
    setting so an individual module could be preview if the doc_frag
    default is stable for example




People Present (lines said)
---------------------------
* acozine (111)
* felixfontein (86)
* samccann (75)
* bcoca (34)
* abadger1999 (21)
* gundalow (10)
* zodbot (8)
* cbudz (2)




Generated by `MeetBot`_ 0.1.4

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