Meeting Log | Ansible Docs | 2023-10-03 15:01:26

[MeetingBot (Ansible Meeting Log Bot)]

DaWGs aka Docs WG | Ansible Docs | #docs:ansible.com

Meeting started by @samccann:ansible.im at 2023-10-03 15:01:26

Meeting summary

1. INFO: official agenda is official agenda at https://forum.ansible.com/t/documentation-working-group-agenda/153/7 and is editable so if you have new topics, please add to the agenda (@samccann:ansible.im, 15:04:51)
2. HALP: (@samccann:ansible.im, 15:05:36)
3. INFO: oranod to open PR to add spellchecking CI soon in the docs repo (@samccann:ansible.im, 15:12:31)
4. INFO: we're getting rapid prs that aren't looking at the details aka changing it's to it is when it really should be its etc (@samccann:ansible.im, 15:14:03)
5. ACTION: samccann to review open hacktoberfest issues to clarify if things are tricky etc (@samccann:ansible.im, 15:15:28)
6. INFO: need notes to not change code or porting guides in each hacktoberfest issue (@samccann:ansible.im, 15:16:06)
7. INFO: should create a cheatsheeet of things to do better next year (@samccann:ansible.im, 15:16:21)
8. TOPIC: Docs plans for rest of year (@samccann:ansible.im, 15:18:18)
1. INFO: ideas include bringing down the issue backlog and move docs guild stuff to the noxfile and get rid of Makefile (@samccann:ansible.im, 15:20:08)
2. INFO: also want to profile the package docs build for performance optimization (@samccann:ansible.im, 15:21:03)
3. INFO: another goal would be to ensure all rst files are part of CI tests, not just the core subset for example (@samccann:ansible.im, 15:23:25)
9. TOPIC: documentation updates (@samccann:ansible.im, 15:27:22)
1. INFO: rstcheck likely runs on all rst files but docs build tests only involve core docs (@samccann:ansible.im, 15:28:22)
2. INFO: core docs on RTD - working to get docs.ansible.com/ansible-core pointo to the content on RTD - needs a proxy for dns magic (@samccann:ansible.im, 15:35:48)
3. INFO: working toward an ecosystem docs repo for the guides (like ee getting started) that talk about multiple projects at once (@samccann:ansible.im, 15:36:15)
10. TOPIC: Open Floor (@samccann:ansible.im, 15:37:12)
1. INFO: need to get better at async documentation working group by using the forum for most topics like the community WG does (@samccann:ansible.im, 15:41:43)
2. ACTION: samccann to revamp the agenda to point to forum topics or issues and ensure more forum topics are opened based on what we discuss in the meeting (@samccann:ansible.im, 15:42:14)

Meeting ended at 2023-10-03 15:50:08

Action items

1. samccann to review open hacktoberfest issues to clarify if things are tricky etc
2. samccann to revamp the agenda to point to forum topics or issues and ensure more forum topics are opened based on what we discuss in the meeting

People present (lines said)

1. @samccann:ansible.im (79)
2. @gotmax:matrix.org (30)
3. @orandon:ansible.im (14)
4. @tvo318:matrix.org (9)
5. @dulemartins:matrix.org (8)
6. @acozine:ansible.im (5)
7. @_discord_848870546254069761:ansible.im (3)
8. @ansibot:ansible.im (2)
9. @remindbot:ansible.im (1)
10. @relaybot:ansible.im (1)

Full logs: full_log.txt