Meeting Log | Ansible Docs | 2023-12-05 16:00:22

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

Meeting started by @samccann:ansible.im at 2023-12-05 16:00:22

Meeting summary

  1. TOPIC: Action item updates (@samccann:ansible.im, 16:02:55)
    1. ACTION: samccann still needs to create a forum topic for where WGs can document their processes (like building and releasing docs, steering committee and community WG process etc) (@samccann:ansible.im, 16:05:11)
  2. TOPIC: Documentation updates (@samccann:ansible.im, 16:05:43)
    1. INFO: reminder that if you use the community ICS meeting calendar, it has moved to https://github.com/ansible-community/meetings/tree/main (@samccann:ansible.im, 16:06:10)
    2. INFO: holiday time coming... multiple folks will be out starting Dec 15 (or sooner) so last DaWGs meeting of the year is next week. (@samccann:ansible.im, 16:07:14)
  3. TOPIC: Tracking ecosystem docsite in this meeting (@samccann:ansible.im, 16:07:49)
    1. INFO: we'll use the DaWGs meeting to help track cross-project docs going to the new ecosystem repo as well. (@samccann:ansible.im, 16:18:47)
    2. ACTION: samccann to add cross-project docs as a standing item in the DaWGs agenda (@samccann:ansible.im, 16:19:10)
  4. TOPIC: removing all scenario guides from devel branch (@samccann:ansible.im, 16:22:03)
    1. INFO: the scenario guides on docs.ansible.com are stale and unmaintained. Proposal is to remove them from devel branch and open issues on related collections to let them know they have until Ansible 10 to copy the info over into their own collection docs (@samccann:ansible.im, 16:28:25)
    2. ACTION: samccann to write up senario guide removal proposal in a forum topic (@samccann:ansible.im, 16:28:39)
  5. TOPIC: how long should stub pages live? (@samccann:ansible.im, 16:30:01)
    1. INFO: when can we change stubs to redirects and remove old stub pages? Vague sense that an seo guru told us 'stub pages are better' but need to dig up that info to see if there were nuances to that. (@samccann:ansible.im, 16:41:02)
  6. TOPIC: Ongoing items (@samccann:ansible.im, 16:42:49)
    1. ACTION: oranod to follow up on a sphinx theme release to capture updated top bar nav (@samccann:ansible.im, 16:45:25)
  7. TOPIC: Open Floor (@samccann:ansible.im, 16:48:01)
    1. ACTION: samccann to open easyfix item to copy readme `nox` instructions into the docs (@samccann:ansible.im, 16:51:30)
    2. ACTION: samccann before making it an easyfix issue - start discussin on how to reconcile what is in docs vs what is in readme wrt local builds and nox (@samccann:ansible.im, 16:55:58)


Meeting ended at 2023-12-05 16:56:30

Action items

  1. samccann still needs to create a forum topic for where WGs can document their processes (like building and releasing docs, steering committee and community WG process etc)
  2. samccann to add cross-project docs as a standing item in the DaWGs agenda
  3. samccann to write up senario guide removal proposal in a forum topic
  4. oranod to follow up on a sphinx theme release to capture updated top bar nav
  5. samccann to open easyfix item to copy readme `nox` instructions into the docs
  6. samccann before making it an easyfix issue - start discussin on how to reconcile what is in docs vs what is in readme wrt local builds and nox


People present (lines said)

  1. @samccann:ansible.im (109)
  2. @acozine:ansible.im (33)
  3. @orandon:ansible.im (29)
  4. @gotmax:matrix.org (7)
  5. @tvo318:matrix.org (3)
  6. @ansibot:ansible.im (2)
  7. @utoddl:matrix.org (1)
  8. @sutapa_b:matrix.org (1)


Full logs: full_log.txt

This topic was automatically closed after 7 days. New replies are no longer allowed.