Meeting Log | Ansible Docs | 2024-06-04 15:00:42

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

Meeting started by @samccann:ansible.im at 2024-06-04 15:00:42

Meeting summary

  1. TOPIC: splitting up the docs (core vs community vs package) (@samccann:ansible.im, 15:04:42)
    1. LINK: https://github.com/ansible/ansible-documentation/issues/1538 (@samccann:ansible.im, 15:05:10)
    2. LINK: https://forum.ansible.com/t/should-we-move-community-guides-to-their-own-docsite-and-repo/4006/8 (@samccann:ansible.im, 15:05:19)
    3. INFO: RTD migration would provide cross-project search so that would solve the search problems (@samccann:ansible.im, 15:13:31)
    4. INFO: to experiment with cross-project search, go to https://ansible.readthedocs.io/en/latest/getting_started_ee/, lclick on the ReadTheDocs flyout menu near the bottom, click search and select include subprojects (@samccann:ansible.im, 15:20:24)
    5. INFO: this also solves the Edit on GitHub problem - since each docsite on RTD has its own option for Edit on GitHub pointing to it's repo, we can continue to provide that option to all our static docs. This was not possible if we just moved Steering committee guides to a separate repo but continued to build the monolithic package docs from multiple repos. (@samccann:ansible.im, 15:22:59)
    6. INFO: we would need to find a way to inlcude 'subprojects:ansible` as an easy one-click option to add to RTD search to get it to search across all Ansible projects (@samccann:ansible.im, 15:41:01)
  2. TOPIC: Open Floor (@samccann:ansible.im, 15:44:03)


Meeting ended at 2024-06-04 15:46:45

Action items

  1. (none)


People present (lines said)

  1. @samccann:ansible.im (69)
  2. @orandon:ansible.im (34)
  3. @tvo318:matrix.org (8)
  4. @utoddl:matrix.org (4)
  5. @felixfontein:matrix.org (4)
  6. @ansibot:ansible.im (2)
  7. @acozine:ansible.im (2)


Full logs: full_log.txt

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