#ansible-docs: Documentation Working Group aka DaWGs
Meeting started by samccann at 16:00:03 UTC
(full logs).
Meeting summary
- opening chatter (samccann, 16:00:09)
- ACTION: samccann to
change room alert to 31 hrs for help wanted nag (samccann,
16:01:01)
- documentation updates (samccann, 16:04:45)
- Community examples (samccann, 16:07:31)
- we're open for community base Ansible examples
here -
https://github.com/ansible-community/community-examples (samccann,
16:13:28)
- https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey
(samccann,
16:16:11)
- a couple more docs survey feedback issues we
could use help on -
https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey
(samccann,
16:16:33)
- splitting up the community guide into getting
started, core, and collection contributor guides -
https://github.com/ansible/ansible/pull/76764 (WIP) (samccann,
16:21:48)
- generating docs for collections (samccann, 16:22:37)
- GitHub actions and reusable workflows you can
use to generate documentation in your own collection repository on
GitHub
-https://github.com/ansible-community/github-docs-build (samccann,
16:23:50)
- actively in use in `community.docer` and
`community.hashi_vault` (samccann,
16:25:56)
- https://github.com/ansible-community/github-docs-build/wiki
(acozine,
16:34:49)
- some early docs available at
https://github.com/ansible-community/github-docs-build/wiki
(samccann,
16:35:13)
- semantic markup (samccann, 16:35:53)
- we found out definitively that this will impact
Automation Hub/ GalaxyNG so need to coordinate with that team
(samccann,
16:37:01)
- if anyone has additional ideas for semantic
markup improvements, now's the time to get them in before the design
goes for internal review with the GalaxyNG teeam! (samccann,
16:41:10)
- proposal -
https://hackmd.io/VjN60QSoRSSeRfvGmOH1lQ (samccann,
16:42:04)
- Open Floor (samccann, 16:56:32)
- ACTION: felixfontein
to write up an addition to the semantic markup to support seealso:
for plugins as well as modules (samccann,
16:57:09)
- ACTION: samcann
acozine - to review https://github.com/ansible/ansible/issues/76609
in terms of how we can add to the cheatsheet and/or create split
controller docs to help out here (and eventual URL added to
`ansible-test --help1` output (samccann,
17:04:59)
Meeting ended at 17:08:05 UTC
(full logs).
Action items
- samccann to change room alert to 31 hrs for help wanted nag
- felixfontein to write up an addition to the semantic markup to support seealso: for plugins as well as modules
- samcann acozine - to review https://github.com/ansible/ansible/issues/76609 in terms of how we can add to the cheatsheet and/or create split controller docs to help out here (and eventual URL added to `ansible-test --help1` output
Action items, by person
- acozine
- samcann acozine - to review https://github.com/ansible/ansible/issues/76609 in terms of how we can add to the cheatsheet and/or create split controller docs to help out here (and eventual URL added to `ansible-test --help1` output
- felixfontein
- felixfontein to write up an addition to the semantic markup to support seealso: for plugins as well as modules
- samccann
- samccann to change room alert to 31 hrs for help wanted nag
People present (lines said)
- samccann (93)
- acozine (40)
- felixfontein (37)
- briantist (34)
- bcoca (15)
- zodbot (8)
- gundalow (4)
- remindbot[m] (3)
Generated by MeetBot 0.4.