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


Meeting started by samccann at 14:31:42 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2019-10-29/dawgs_aka_docs_working_group.2019-10-29-14.31.log.html
.



Meeting summary
---------------
* Fixing edit Github on CLI autogenerated pages  (samccann, 14:35:13)
  * LINK: https://github.com/ansible/ansible/pull/63697   (samccann,
    14:35:17)
  * AGREED: - we don't want edits on the cli pages as it's not  just
    changing yaml etc. So remove edit on github from those cli pages
    (samccann, 14:49:39)
  * we should allow edits on plugins as they are also embedded docs like
    module pages  (samccann, 14:50:18)
  * also get edit on github working for other embedded docs such as
    keywords  (samccann, 14:51:03)
  * LINK:
    https://github.com/ansible/ansible/blob/devel/lib/ansible/cli/adhoc.py#L49
    (bcoca, 14:52:03)
  * LINK:
    https://github.com/ansible/ansible/blob/devel/docs/docsite/keyword_desc.yml
    <= source for keyword faq  (bcoca, 14:56:26)
  * AGREED: remove edit on Github links for cli pages  (samccann,
    15:01:44)

* linking to Playbook keywords from other examples  (samccann, 15:07:07)
  * LINK:
    https://docs.ansible.com/ansible/devel/reference_appendices/playbooks_keywords.html
    (samccann, 15:07:47)
  * LINK:
    https://docs.ansible.com/ansible/latest/user_guide/playbooks_environment.html
    <= also update this since it doesn't clarify the definition  (bcoca,
    15:07:51)
  * LINK: https://github.com/ansible/ansible/issues/63947 <= we get this
    kind of issue all the time  (bcoca, 15:09:06)
  * LINK: https://github.com/ansible/ansible/issues/63947   (samccann,
    15:10:15)
  * use issue 63947 for an example of the confusion the environment
    keyword causes users  (samccann, 15:10:37)
  * LINK:
    https://docs.ansible.com/ansible/latest/user_guide/playbooks_environment.html
    (samccann, 15:10:51)
  * playbooks_environment.rst also needs updating as it doesn't clarify
    the definition  (samccann, 15:11:15)

* Docs PRs  (samccann, 15:13:21)
  * LINK:
    https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#creating-valid-variable-names
    (acozine, 15:17:25)
  * LINK: https://github.com/ansible/ansible/pull/64040   (samccann,
    15:24:04)

* OpenFloor  (samccann, 15:29:27)

Meeting ended at 15:33:41 UTC.




Action Items
------------





Action Items, by person
-----------------------
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (76)
* bcoca (70)
* acozine (52)
* falcon78921 (12)
* gundalow (10)
* zodbot (9)
* Xaroth (0)




Generated by `MeetBot`_ 0.1.4

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