Meeting Log | Ansible Docs | 2023-09-12 15:01:43

DaWGs aka Documentation Working Group Meeting | Ansible Docs | #docs:ansible.com

Meeting started by @samccann:ansible.im at 2023-09-12 15:01:43

Meeting summary

  1. TOPIC: ^info we use the Matrix meeting bot here, the commands are ^info, ^action, and ^topic. These commands only work from Matrix right now (@samccann:ansible.im, 15:02:25)
  2. TOPIC: Matrix Notifications from Discourse ^topic (@samccann:ansible.im, 15:07:04)
  3. TOPIC: Do we want Matrix notifications from Discourse (@samccann:ansible.im, 15:08:15)
    1. INFO: we have the ability to enable forum notifications in the docs channel in matrix for each forum post labeled `documentation` for example (@samccann:ansible.im, 15:11:52)
    2. INFO: we an turn it off etc if we find it too annoying (@samccann:ansible.im, 15:12:05)
    3. ACTION: samccann to post topic in forum to ask if docs group wants forum notifications for docs enabled in...docs channel (@samccann:ansible.im, 15:12:49)
  4. TOPIC: Moving core docs to ReadTheDocs (@samccann:ansible.im, 15:13:45)
    1. INFO: details at https://github.com/ansible/ansible-documentation/issues/377 (@samccann:ansible.im, 15:16:51)
    2. INFO: outline of this effort at https://github.com/ansible/ansible-documentation/issues/377 (@samccann:ansible.im, 15:17:39)
    3. INFO: the RTD effort here provides a more modern infrastructure for the core docs and brings it in alignment with the rest of the Ansible ecosystem docs hosted on ReadTheDocs. and also continues our effort to remove dependencies on internal RH infrastructure for our community documentation (@samccann:ansible.im, 15:22:54)
    4. INFO: the change to RTD gives us PR previews, PDF builds, ability to inject custom widgets that could point to the forum etc (@samccann:ansible.im, 15:25:46)
  5. TOPIC: What kind of links should we allow in Ansible documentation (@samccann:ansible.im, 15:37:33)
    1. INFO: details at https://forum.ansible.com/t/what-kind-of-links-should-we-allow-in-ansible-documentation/370 (@samccann:ansible.im, 15:37:47)
  6. TOPIC: ongoing work (@samccann:ansible.im, 15:43:53)
    1. INFO: AWX docs updated at https://ansible.readthedocs.io/projects/awx/en/latest/ (@samccann:ansible.im, 15:45:18)
  7. TOPIC: Open Floor (@samccann:ansible.im, 15:46:52)
    1. INFO: still looking for help on creating and ansible cheatsheet - https://github.com/ansible/ansible-documentation/issues/48 (@samccann:ansible.im, 15:49:42)
    2. INFO: or help on any of our 55 open docs issue - https://github.com/ansible/ansible-documentation/issues (@samccann:ansible.im, 15:50:10)
    3. INFO: discussion home for eocsstem docs, tutorials, and how-to guides - https://forum.ansible.com/t/tutorials-and-how-tos-for-the-ansible-ecosystem/122/5 (@samccann:ansible.im, 15:52:22)


Meeting ended at 2023-09-12 15:54:38

Action items

  1. samccann to post topic in forum to ask if docs group wants forum notifications for docs enabled in...docs channel


People present (lines said)

  1. @samccann:ansible.im (84)
  2. @orandon:ansible.im (35)
  3. @acozine:ansible.im (34)
  4. @gwmngilfen:ansible.im (6)
  5. @sutapa_b:matrix.org (2)


Full logs: full_log.txt

1 Like