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


Meeting started by samccann at 15:02:10 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2023-05-30/documentation_working_group_aka_dawgs.2023-05-30-15.02.log.html
.



Meeting summary
---------------
* official agenda at
  https://github.com/ansible/community/issues/678#issuecomment-1563022811
  (samccann, 15:04:24)
* Documentation Updates  (samccann, 15:07:06)
  * Ansible 8 will be released today! Docs release prep in the works as
    well.  (samccann, 15:07:16)
  * ansible-core 2.12 is EOL... will update the docs accordingly this
    week  (samccann, 15:07:34)

* Execution Environments  (samccann, 15:08:08)
  * ansible-builder 3.0 is out and needs new/updated docs  (samccann,
    15:08:30)
  * andersson007_ is leading the effort and drafting out some of this
    (samccann, 15:08:50)
  * see https://github.com/ansible-community/community-team/issues/230
    to help out  (samccann, 15:09:03)
  * there is also this PR where folks can help with documenting the ENV
    ANSIBLE_GALAXY_SERVER_* vars:
    https://github.com/ansible/ansible-builder/pull/538  (oranod,
    15:09:38)
  * these EE docs are a new 'category' in that the how to guide will
    span more than one Ansible community project (builder, AWX,
    stand-alone use, etc)  (samccann, 15:19:24)
  * AWX might have similar content to controller on using EEs in job
    templates -
    https://docs.ansible.com/automation-controller/latest/html/userguide/execution_environments.html
    (samccann, 15:21:31)
  * controller has
    https://docs.ansible.com/automation-controller/latest/html/userguide/execution_environments.html
    and AWX has
    https://github.com/ansible/awx/blob/devel/docs/execution_environments.md
    for EEs in job templates (tho the latter may not be up-to-date)
    (samccann, 15:22:36)
  * and in general, most docs are not up todate with Builder 3.0
    (samccann, 15:22:50)
  * ACTION: samccann to inform community-writers about EE epic for a
    place to help out  (samccann, 15:24:35)
  * Need help on  collection dependencies docs issue -
    https://github.com/ansible/ansible/issues/80435 and
    https://github.com/ansible-community/community-topics/issues/224
    (samccann, 15:27:44)

* Ansible command cheatsheet  (samccann, 15:29:39)
  * looking for help on creating a cheatsheet for ansible commands -
    https://github.com/ansible/ansible/issues/75509  (samccann,
    15:29:51)
  * ACTION: samccan to ask on reddit 'how do you use this cli command'
    type questions for feedback  (samccann, 15:33:41)

* Ansible 8 release  (samccann, 15:37:52)
  * Ansible 8  docs up on test at
    http://docs.testing.ansible.com/ansible/8/index.html  Please review
    and let us know if you see problems. Ignore version switcher as
    those PRs still need to be backported etc  (samccann, 15:38:07)
  * major kudos to oranod for getting ansible-core 2.15 docs published
    and the prep work for Ansible 8  (samccann, 15:39:19)

* Doc tools and docsite  (samccann, 15:39:47)
  * here is the link with details if anyone wants to contribute to
    improving the jinja templates for the docsite:
    https://github.com/ansible/jinja-docsite/issues/108  (oranod,
    15:41:40)

* Adding to the community-writers project board  (samccann, 15:47:33)
  * this board is for community members interested in growing their
    writing skills or technical writers interested in helping with
    ansible docs  (samccann, 15:48:05)
  * two main categories of issues - those that can be fixed with Edit on
    Github, or those that require git knowledge  (samccann, 15:48:35)
  * you can also post a PR for techwriter review there  (samccann,
    15:48:46)
  * copy a link from your issue or PR and add it to the board
    (samccann, 15:49:10)
  * a writer assigns the issue to themselves in the dropdown box on that
    page so other's know someone has taken it  (samccann, 15:56:27)

* Open Floor  (samccann, 15:57:58)

Meeting ended at 15:59:34 UTC.




Action Items
------------
* samccann to inform community-writers about EE epic for a place to help
  out
* samccan to ask on reddit 'how do you use this cli command' type
  questions for feedback




Action Items, by person
-----------------------
* samccann
  * samccann to inform community-writers about EE epic for a place to
    help out
* **UNASSIGNED**
  * samccan to ask on reddit 'how do you use this cli command' type
    questions for feedback




People Present (lines said)
---------------------------
* samccann (122)
* oranod (27)
* acozine (22)
* zodbot (9)
* TVo[m] (8)
* sutapa_b[m] (5)
* bcoca (3)
* felixfontein (1)
* TVo (0)
* sutapa_b (0)
* Don (0)
* Naro (0)




Generated by `MeetBot`_ 0.4

.. _`MeetBot`: https://fedoraproject.org/wiki/Zodbot#Meeting_Functions