Notification time stamped 2020-05-05 16:13:22 UTC
===========================================
#ansible-docs: Docs Working Group aka DaWGs
===========================================
Meeting started by acozine at 14:31:34 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-05-05/docs_working_gr...
.
Meeting summary
---------------
* checking in about changelogs (acozine, 14:39:53)
* LINK:
https://github.com/ansible-collections/overview/issues/18
(acozine, 14:39:57)
* Ansible-maintained content team considering reno with added work to
produce the changelog.yml that felix's work requires. (samccann,
14:41:29)
* felixfontein wrote up a spec for the changelog.yaml format
(
https://github.com/ansible/ansible/blob/devel/packaging/release/changelog...)
and added a linter for changelog.yaml files to the generator
(samccann, 14:43:28)
* felixfontein also prepared a WIP PR to replace ansible's changelog
generator with it:
https://github.com/ansible/ansible/pull/69313
(samccann, 14:46:38)
* LINK:
https://github.com/ansible-community/ansibulled
(abadger1999, 14:47:16)
* docs pipeline update (acozine, 14:53:12)
* mock collection to experiment with changelog generator -
https://github.com/felixfontein/ansible-versioning_test_collection
(samccann, 14:56:00)
* LINK:
https://www.irccloud.com/pastebin/MVT9chqV/ (samccann,
14:57:55)
* updated ACD changelog generator WIP hack:
https://github.com/felixfontein/ansibulled/tree/acd-changelog/acd_changelog
with result:
https://github.com/felixfontein/ansibulled/blob/acd-changelog/acd_changel...
(acozine, 14:59:27)
* The collection downloading and generation of rst from those
collection files will live in ansibulled:
https://github.com/ansible-community/ansibulled/pull/5 (samccann,
15:04:13)
* The idea is that this will be usable for both the docs pipeline and
external collection authors who want to build docs for just their
collections. (samccann, 15:04:46)
* new collections pipeline will be split into two parts, the
ansibulled part mentioned above, which generates rST from plugin
docstrings, and the Sphinx (rST-to-HTML) part (acozine, 15:20:36)
* collections owners can use ansibulled-docs to generation rST from
their plugin docstrings (acozine, 15:21:34)
* AGREED: would be good if ansibulled-docs also outputs index.rst
files. Will be handy if/when scenario guides are moved into
collections /docs folder and pulled back to
docs.ansible.com
(samccann, 15:24:32)
* ansible_metadata (acozine, 15:29:56)
* LINK:
https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_docu...
defines the format (gundalow, 15:32:33)
*
https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_docu...
defines the format (samccann, 15:33:00)
* LINK:
https://github.com/ansible/ansible/pull/67684 (felixfontein,
15:33:44)
* collections meta/routing.yml handles module deprecation in a
collection (samccann, 15:36:08)
* LINK:
https://github.com/ansible/ansible/pull/68646 (samccann,
15:36:54)
* supported_by metadata seems to no longer serve a purpose. TBD on
whether collection owners/core still want status field in the
metadata (stable vs preview etc) (samccann, 15:45:43)
* in summary - ansible-base is phasing out ANSIBLE_METADATA entirely,
collections 'may' still want to use the status field but we need to
followup to see if that's true (samccann, 15:48:22)
* collection meta/routing.yml should be the source of truth for
deprecation/removed and we can move any other status needs into an
optional DOCUMENTATION field (samccann, 15:51:16)
* consider ignoring ANSIBLE_METADATA entirely when building collection
docs (samccann, 16:05:54)
* open floor (acozine, 16:09:38)
Meeting ended at 16:13:22 UTC.
Action Items
------------
Action Items, by person
-----------------------
* **UNASSIGNED**
* (none)
People Present (lines said)
---------------------------
* acozine (132)
* abadger1999 (78)
* felixfontein (78)
* samccann (41)
* gundalow (12)
* zodbot (11)
* bcoca (6)
* dmellado (1)
* tremble (1)
* briantist (1)
Generated by `MeetBot`_ 0.1.4
.. _`MeetBot`:
http://wiki.debian.org/MeetBot
https://meetbot.fedoraproject.org/ansible-docs/2020-05-05/docs_working_gr...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...