documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 15:02:10 UTC (full logs).

Meeting summary

    1. official agenda at https://github.com/ansible/community/issues/678#issuecomment-1563022811 (samccann, 15:04:24)

  1. Documentation Updates (samccann, 15:07:06)
    1. Ansible 8 will be released today! Docs release prep in the works as well. (samccann, 15:07:16)
    2. ansible-core 2.12 is EOL... will update the docs accordingly this week (samccann, 15:07:34)

  2. Execution Environments (samccann, 15:08:08)
    1. ansible-builder 3.0 is out and needs new/updated docs (samccann, 15:08:30)
    2. andersson007_ is leading the effort and drafting out some of this (samccann, 15:08:50)
    3. see https://github.com/ansible-community/community-team/issues/230 to help out (samccann, 15:09:03)
    4. 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)
    5. 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)
    6. 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)
    7. 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)
    8. and in general, most docs are not up todate with Builder 3.0 (samccann, 15:22:50)
    9. ACTION: samccann to inform community-writers about EE epic for a place to help out (samccann, 15:24:35)
    10. 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)

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

  4. Ansible 8 release (samccann, 15:37:52)
    1. 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)
    2. major kudos to oranod for getting ansible-core 2.15 docs published and the prep work for Ansible 8 (samccann, 15:39:19)

  5. Doc tools and docsite (samccann, 15:39:47)
    1. 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)

  6. Adding to the community-writers project board (samccann, 15:47:33)
    1. 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)
    2. two main categories of issues - those that can be fixed with Edit on Github, or those that require git knowledge (samccann, 15:48:35)
    3. you can also post a PR for techwriter review there (samccann, 15:48:46)
    4. copy a link from your issue or PR and add it to the board (samccann, 15:49:10)
    5. 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)

  7. Open Floor (samccann, 15:57:58)


Meeting ended at 15:59:34 UTC (full logs).

Action items

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


Action items, by person

  1. samccann
    1. samccann to inform community-writers about EE epic for a place to help out


People present (lines said)

  1. samccann (122)
  2. oranod (27)
  3. acozine (22)
  4. zodbot (9)
  5. TVo[m] (8)
  6. sutapa_b[m] (5)
  7. bcoca (3)
  8. felixfontein (1)
  9. TVo (0)
  10. sutapa_b (0)
  11. Don (0)
  12. Naro (0)


Generated by MeetBot 0.4.