===========================================
#ansible-docs: Docs Working Group aka DaWGs
===========================================


Meeting started by acozine at 16:00:19 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-01-05/docs_working_group_aka_dawgs.2021-01-05-16.00.log.html
.



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)
  * LINK:
    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)
  * LINK:
    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)
  * LINK:
    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)
  * LINK: 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.




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
* **UNASSIGNED**
  * (none)




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

.. _`MeetBot`: http://wiki.debian.org/MeetBot