samccann's meeting titled "DaWGs aka Docs Working Group" ended in
#ansible-docs
by notifications@fedoraproject.org
Notification time stamped 2019-10-01 15:31:23 UTC
===========================================
#ansible-docs: DaWGs aka Docs Working Group
===========================================
Meeting started by samccann at 14:31:26 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2019-10-01/dawgs_aka_docs_...
.
Meeting summary
---------------
* Filter page docs discussion (samccann, 14:33:53)
* LINK:
https://docs.ansible.com/ansible/latest/user_guide/playbooks_filters.html
(samccann, 14:34:09)
* filter docs page is too long, bad SEO experience since cannot search
on an individual filter, and lacks examples (samccann, 14:40:30)
* we could model the filters after the plugins - have a 'main page'
that explains in general and then link to each with specific
docs/examples (samccann, 14:41:29)
* LINK:
https://docs.ansible.com/ansible/latest/user_guide/playbooks_filters_ipad...
(samccann, 14:45:50)
* LINK: https://github.com/ansible/ansible/pull/46979 (bcoca,
14:50:24)
* wip pr adding more examples - #link
https://github.com/ansible/ansible/pull/46979 (samccann, 14:51:22)
* 'tests' have a similar problem to the filters page (samccann,
14:56:28)
* LINK:
https://docs.ansible.com/ansible/latest/dev_guide/testing/sanity/index.ht...
(acozine, 14:58:18)
* AGREED: - consider breaking up the filters page into high level
groupings with more examples for each filter type (samccann,
14:58:34)
* LINK:
https://docs.ansible.com/ansible/latest/user_guide/playbooks_tests.html
(bcoca, 14:59:05)
* LINK:
https://docs.ansible.com/ansible/latest/user_guide/playbooks_tests.html
for jinja2 tests (samccann, 14:59:30)
* support elements in return values in documentation (samccann,
15:08:29)
* LINK: https://github.com/ansible/ansible/pull/62929 for sample PR
(samccann, 15:09:01)
* AGREED: worth adding support for elements in return value docs
(samccann, 15:23:07)
* open floor (acozine, 15:24:18)
Meeting ended at 15:31:23 UTC.
Action Items
------------
Action Items, by person
-----------------------
* **UNASSIGNED**
* (none)
People Present (lines said)
---------------------------
* acozine (81)
* samccann (50)
* bcoca (25)
* cyberpear (22)
* felixfontein (9)
* zodbot (8)
Generated by `MeetBot`_ 0.1.4
.. _`MeetBot`: http://wiki.debian.org/MeetBot
https://meetbot.fedoraproject.org/ansible-docs/2019-10-01/dawgs_aka_docs_...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...
4 years, 6 months