15:01:32 #startmeeting Documentation Working Group aka DaWGs 15:01:32 Meeting started Tue May 9 15:01:32 2023 UTC. 15:01:32 This meeting is logged and archived in a public location. 15:01:32 The chair is oranod. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 15:01:32 Useful Commands: #action #agreed #halp #info #idea #link #topic. 15:01:32 The meeting name has been set to 'documentation_working_group_aka_dawgs' 15:01:39 @room Meeting time! Who is here to talk the docs? 15:01:48 Raise your ascii hand (o/) to say hi or any other way you want to let us know you are here. And Welcome to any new folks! 15:01:48 To any newcomers - again, welcome. We chair all attendees as a way of recognizing your time spent here. And it opens it up for people to add to the meeting minutes with commands like #info or #link (to add a link) 15:01:48 General run of the meeting - We go over action items, give docs updates.. maybe have a topic or two, and go over doctooling updates (all the fun stuff behind the scenes that get us docs.ansible.com!) 15:02:26 #info meeting agenda at: https://github.com/ansible/community/issues/678#issuecomment-1540317407 15:02:41 chair acozine 15:02:50 #chair acozine 15:02:50 Current chairs: acozine oranod 15:03:02 heh 15:03:02 hi acozine hope you're doing well 15:03:13 yeah 2nd time's the charm 15:03:25 Hi Don Naro spring has sprung here, finally, I am madly planting seedlings 15:03:27 how's by you? 15:03:52 spring has sprung here too and it's so good! 15:04:06 I got my pumpkins planted out yesterday 15:04:31 and I checked my banana tree that I wrapped up over the winter. and it survived! 15:04:47 o/ hi. 15:04:54 @TVo! welcome 15:05:01 #chair TVo 15:05:01 Current chairs: TVo acozine oranod 15:05:30 I'm on another community meeting at the moment. Hope you're all doing good. Hi acozine ! 15:05:40 Pelisse Romain: you around today? or briantist maybe? felixfontein you able to join us? 15:05:43 Hi TVo! 15:05:54 glad you're here with us TVo 15:06:11 feel free to just hang out and say hi while you're at your other community meeting 15:06:39 I'll be honest that I don't have a TON of stuff for the agenda and am just trying to fill in until samccann returns from her brief hiatus 15:07:45 #info I did send Pelisse Romain a PR last week to add details on contributing to the Ansible Middleware Collection docs, which you should be able to visit at https://ansiblemiddleware.com/ 15:08:24 #info for our doc contributors out there, the Ansible Middleware Collections are looking for some help with their docs so please visit the link above to see how you can get invovled 15:08:46 s/invovled/involved 15:09:25 let me check quickly for any other doc actions from last week... 15:11:37 #info last week we also discussed either creating stub pages or redirecting some of the random html pages on the docsite that still get hits. the consensus seemed to be going for stubs instead of redirects. I've started a PR but haven't sent it 15:12:09 just so you know last week was super short for me as there were bank holidays and I was pretty much out sick for a couple of days 15:12:31 I'll ping the room when I send that PR and ask for reviews 15:14:12 #topic general updates 15:14:39 I forgot to set a topic for the previous batch of info items but hopefully that'll work out alright 15:16:55 #info carrying on from some of the efforts to provide contributor opportunities for doc writers, there has been some work going on to create a writer's toolkit that will provide resources for people who want to do some writing work 15:17:33 as I mentioned last week it will really help when the forum is in place so we've got a central place to put those resources 15:17:41 any PRs for the cheatsheet work from community writers? 15:18:21 I've got some time to do reviews 15:18:47 I could also review other PRs, but we've chatted about the cheatsheet a bit lately 15:19:10 so I thought there might be new work in that area 15:19:11 oh nice. I'm sorry but could you remind me what cheatsheet that is? might be buried in my bookmarks or a tab somewhere 15:19:26 or are you talking about that writer's toolkit? 15:19:37 maybe I'm confusing things 15:20:13 this is the start of the cheatsheet: https://docs.ansible.com/ansible/latest/command_guide/cheatsheet.html 15:20:22 and somewhere we have tickets for expanding it to cover other CLI commands 15:20:40 speaking of central place for resources, what is the proper way to get an entirely new resource on t he docsite? 15:20:47 Just open an issue in the docsite repo? 15:21:16 here it is: https://github.com/ansible/ansible/issues/75509 15:21:25 snap 15:22:16 TVo: do you mean like publish a new set of project docs on `docs.ansible.com` or something? 15:24:29 @Don Naro - yes 15:25:28 TVo: I think the best thing in that case would probably be set up a project on read the docs. can you share what new resource you're talking about? 15:27:28 sorry, I'm not really around today... 15:27:44 hi felixfontein that's ok. nice to hear from you though. 15:27:45 would be glad if folks who use antsibull-docs could try out the 2.0.0a1 release :) 15:28:50 #info antsibull-docs 2.0.0a1 is released so update to the new version and try it out 🚀 15:30:01 Don Naro: Ansible rulebook 15:30:30 ah, ok. I thought they were already on readthedocs, I know EDA is. 15:30:52 but, yeah, I would say setting up a project on readthedocs is the way to go there. do you think I could help with that? 15:33:18 #info speaking of releases, core-2.15 is coming up next week on the 15th. I'll be helping finish up the release checklist and thought I'd drop the info in if someone else wants to get involved in the proceedings 15:33:24 #link https://github.com/ansible/ansible/issues/80452 15:34:13 #info we'll basically need to update the version switcher by merging and backporting samccann 's PR 15:34:23 #link https://github.com/ansible/ansible/pull/80556 15:35:12 #info then we need to set the version to 2.15 on the stable-2.15 branch 15:36:39 of course there's running all the jenkins jobs to publish but I'll have to do that myself. tbh probably not a whole lot for community folks to do here. 15:37:20 and I was also thinking about running down some of the details about the publishing process for Ansible 8 but I think I'll wait for Sandra to get back and talk it over with her 15:37:31 #topic Open Floor 15:37:52 let's open things up. anyone got something they want to talk about? 15:38:31 you mentioned the forum earlier, what's going on with that? 15:39:15 I haven't heard an update for a while (or maybe i've just been too busy in the garden?) 15:40:03 I don't think there's much I can actually say there. and perhaps I was speaking a bit too soon but the community team is keenly aware that the Ansible community lacks a central web presence, of which a forum is a big part 15:40:28 Gwmngilfen: could keep me honest on the details here actually 15:41:32 ah here we go.... 15:41:37 #link https://github.com/ansible-community/community-topics/issues/202 15:43:10 so there is stuff I can actually say with this one. I forget the state of things and didn't want to give incorrect impressions or say things that don't match reality. 15:44:30 thanks for the link 15:44:36 as Greg mentions at the bottom of his post he is busy working towards setting up a Discourse forum. once that is up and running, it will be a tremendous boost for things like the writer's toolkit and a central place where we can post and track a lot of the contributor opportunities 15:44:43 I think I was on vacation when the final vote happened 15:45:33 thanks for the updates Don Naro I'm need to prep for my next meeting 15:45:39 see you all later! 15:45:55 you're welcome acozine have great one. and enjoy the gardening" 15:46:10 bah. s/"/! 15:46:10 thanks! 15:46:15 #unchair acozine 15:46:15 Current chairs: TVo oranod 15:46:17 heh, typos shall we have ever with us 15:46:34 heh 15:47:08 ok, anyone else around with some doc stuff to talk about? 15:49:27 #info I recently got the chance to share some playbooks I wrote for converting markdown or rst to asciidoc but you could adapt them for other conversions. maybe someone out there might find them useful for their doc set. 15:49:31 #link https://github.com/oraNod/ansible-conversion-playbooks 15:49:51 (or maybe someone can see a way to improve them) 15:53:50 ok if there's nothing else, let's wrap 15:53:51 #endmeeting