#ansible-docs: Docs Working Group aka DaWGs
Meeting started by acozine at 16:00:19 UTC
(full logs).
Meeting summary
- opening chatter (acozine, 16:00:28)
- long-running issues from https://github.com/ansible/community/issues/579#issuecomment-750470261 (acozine, 16:09:27)
- https://www.irccloud.com/pastebin/hNYJt512/list%20of%20long-running%20topics
(acozine,
16:13:24)
- AGREED: remove
bitflip release process from the active agenda for now (acozine,
16:17:35)
- https://meetbot.fedoraproject.org/ansible-docs/2020-12-15/dawgs_aka_docs_working_group.2020-12-15-16.01.log.html
if you want to see it (samccann,
16:19:17)
- last we talked about module formatting, we
decided to check how many C(), I() etc is already in the docs. Then
create a proposal for full semantic markup based on how hard it
would be to change everything (samccann,
16:21:11)
- ansible-docs code removes markup so not a big
impact if we go to semantic or other markup changes (samccann,
16:32:24)
- CI may not be possible to enforce markup down
the road, but might be if we choose good markup names? (samccann,
16:33:00)
- https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_documenting.html#linking-and-other-format-macros-within-module-documentation
(acozine,
16:39:07)
- do we or don't we adopt semantic markup (samccann, 16:46:51)
- ACTION: acozine to
create a WIP PR that illustrates proposed semantic markup, solicit
feedback (acozine,
16:54:39)
- AGREED: - create a
WIP PR that changes the documentation to what we are proposing
(semantic) and use that for review/feedback (samccann,
16:54:41)
- https://www.irccloud.com/pastebin/zyXyNCqJ/
(acozine,
16:55:48)
- docs survey (acozine, 16:57:36)
- open floor (acozine, 16:59:25)
- if you have question, concern, or idea related
to Ansible docs, you can bring it up in the ansible-docs channel at
any time, or add it to the DaWGs meeting agenda by adding a comment
to https://github.com/ansible/community/issues/579 (acozine,
17:03:17)
- everyone is welcome in the channel and in all
meetings (acozine,
17:03:37)
- we will have the supplemental docs meeting on
Thurs at 10:30ET to discuss/update on the docsite split (samccann,
17:07:36)
Meeting ended at 17:08:25 UTC
(full logs).
Action items
- acozine to create a WIP PR that illustrates proposed semantic markup, solicit feedback
Action items, by person
- acozine
- acozine to create a WIP PR that illustrates proposed semantic markup, solicit feedback
People present (lines said)
- acozine (122)
- samccann (64)
- felixfontein (30)
- gundalow (22)
- abadger1999 (17)
- bcoca (17)
- zodbot (10)
- gwmngilfen (7)
- tadeboro (5)
- lmodemal (2)
- dericcrago (1)
- dmsimard (0)
Generated by MeetBot 0.1.4.