#ansible-docs: Docs Working Group aka DaWGs
Meeting started by acozine at 15:00:27 UTC
(full logs).
Meeting summary
- opening chatter (acozine, 15:00:32)
- collection extra docs and Ansible 4.1 release . . . (acozine, 15:07:34)
- community.crypto, community.general and
community.docker have docs/docsite folders (samccann,
15:08:25)
- these should show up in their new place on
docs.ansible.com/ansible after 4.1.0 releases (aka collection must
be in the Ansible package before the docs will show up) (samccann,
15:09:04)
- see
https://docs.ansible.com/ansible/devel/dev_guide/developing_collections_structure.html#docs-directory
for details on how to move scenario guides to a collection
repo (samccann,
15:13:02)
- and see
https://github.com/ansible-collections/amazon.aws/pull/362 for an
example of a moved scenario guide (samccann,
15:13:25)
- use `antsibull-lint collection-docs` for some
first sanity checks (samccann,
15:16:15)
- Ansible Sphinx theme (acozine, 15:26:54)
- ansible-theme should be mergable soon. One
final check on staging (samccann,
15:30:37)
- semantic markup (acozine, 15:32:25)
- https://github.com/ansible/ansible/pull/73137
(acozine,
15:32:36)
- discussion from
https://github.com/ansible/ansible/pull/73137 (acozine,
15:32:53)
- considering leaving `M()` as is, and adding
`P(name#type)` for all plugins e.g. `P(ansible.builtin.apt#module)`
etc (samccann,
15:39:54)
- open floor (acozine, 15:46:46)
- https://hackmd.io/lAJfWYrlT3Gg1VXYGBoZtA
(acozine,
15:56:16)
- we will be trying to create 'personas' and how
each different ansible docs reader is looking for info in our docs.
More to come (samccann,
15:59:07)
- agenda items can be added to
https://github.com/ansible/community/issues/579 at any time by
anyone (samccann,
16:02:08)
Meeting ended at 16:03:08 UTC
(full logs).
Action items
- (none)
People present (lines said)
- acozine (106)
- felixfontein (46)
- samccann (42)
- zodbot (8)
- briantist (8)
- cyberpear (2)
- lmodemal (2)
- gundalow (1)
- baptistemm (1)
Generated by MeetBot 0.1.4.