#ansible-docs: Docs Working Group aka DaWGs
Meeting started by acozine at 14:31:52 UTC
(full logs).
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)
- 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)
- 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
(full logs).
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
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.