15:00:39 #startmeeting Documentation Working Group aka DaWGs 15:00:39 Meeting started Tue May 16 15:00:39 2023 UTC. 15:00:39 This meeting is logged and archived in a public location. 15:00:39 The chair is oranod. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 15:00:39 Useful Commands: #action #agreed #halp #info #idea #link #topic. 15:00:39 The meeting name has been set to 'documentation_working_group_aka_dawgs' 15:00:50 @room Meeting time! Who is here to talk the docs? 15:01:04 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:06 Welcome to any new joiners. 15:01:06 We chair all attendees to recognize the time you spend here and give you the ability to add to meeting minutes with commands like #info or #link (to add a link) 15:01:07 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:01:07 #info meeting agenda at https://github.com/ansible/community/issues/678#issuecomment-1549686517 15:01:56 o/ 15:02:02 Hello! 15:02:05 #chair sutapa_b 15:02:05 Current chairs: oranod sutapa_b 15:02:13 #chair TVo 15:02:13 Current chairs: TVo oranod sutapa_b 15:02:23 hey TVo and sutapa_b ! 15:02:28 hope you're both doing well 15:03:09 I'm doing good. 15:03:13 amazing weather here (west of Ireland) and I was having coffee in the garden enjoying the sun a few mins ago. feels so good to have some fine weather for a change. 15:03:25 nice to hear that sutapa_b 15:03:33 TY, how are you? 15:03:47 I'm doing well, cheers 15:04:02 Good! 15:04:24 sutapa_b: I've got a couple of agenda items but is there anything you wanted to bring forward to start us off? 15:04:45 I'll be a bit late 15:04:51 (later, that is) 15:04:55 no worries acozine hello! 15:05:10 not really you can start. 15:05:23 Hi 15:05:47 ok, cool. sutapa_b just thought I'd give you the chance if you had something 15:05:52 hi Dule_Martins#0383 welcome! 15:05:56 hope you're keeping well 15:06:27 Hey Don Naro, All Good just some stress from job hunting 15:06:50 Miss everyone here, heard samcann (@_discord_930864645756035143:ansible.im) is on Vac 15:06:58 yeah Dule_Martins#0383 I bet that is stressful but good luck with it! 15:07:26 indeed samccann is taking some time away but will be back with us soon 15:07:56 #info we all miss samccann and look forward to her return 15:08:05 Thanks Mate 15:08:36 Ya sure, so what are we talking about today 15:08:49 well, a number of things 15:09:00 #agenda updates on documentation work 15:09:33 s/agenda/topic/ 15:10:16 #info quick update on core 2.15 doc publishing. I've been waiting on a backport to stable-2.15 but that should be merged shortly and I'll get the docs published and updated 15:10:44 o/ 15:10:59 not sure if anyone has noticed that or not but core 2.15 was released yesterday but I'm still waiting to get docs publishing done. fingers crossed here soon. 15:11:07 Welcome felixfontein 15:11:09 #chair felixfontein Dule_Martins#0383 15:11:09 Current chairs: Dule_Martins#0383 TVo felixfontein oranod sutapa_b 15:11:32 sorry I forgot to chair you earlier Dule_Martins#0383 I need to work on my meeting hashtag game 15:11:54 lol! that's fine Don Naro 15:12:06 What are my duties as chair? 15:13:03 #info docsite update PR at: https://github.com/ansible/docsite/pull/171 - this adds the `ansible_community.html` page that we've talked about in previous meetings to fix a "gap" in one of the pages that is deprecated with the new docsite. but analytics seem to indicate there are people still hitting that page from bookmarks. 15:13:34 #info that docsite PR also updates the "oldsite" controller pages for 4.2.2 TVo 15:14:07 Dule_Martins#0383: no duties as such as chair. it's just a way to recognize the time you spend here. plus you can use the meeting commands / hashtags. 15:14:17 o/ 15:14:34 #chair acozine 15:14:34 Current chairs: Dule_Martins#0383 TVo acozine felixfontein oranod sutapa_b 15:14:49 Oh cool o/ 15:14:59 everyone's furniture around here ;) 15:15:40 #info last week we also talked about the old tower page at: https://docs.ansible.com/ansible-tower/index.html - I've looked into that but still need to figure out if it is automatically updated/generated from a repo somewhere or not. 15:16:48 @tvo do you know where that comes from? 15:17:35 I would have guessed from the old static docsite repo, but I don't have access to that any more to confirm or deny. 15:17:51 It comes from the docsite repo 15:18:21 docsite>oldsite 15:19:00 Don Naro: correct 15:19:02 So @tvo you are saying the old tower page is automatically updated from the docsite repo 15:19:39 if so, Don Naro, what were your expectation of the docs from the old tower page? 15:19:53 Dule_Martins#0383: Not anymore, it used to be before we switched it over to automation-controller 15:20:19 We don't need that anymore; it's old and obsolete 15:20:26 Ooh! Thanks on that @tvo 15:21:37 TVo: did it come from https://github.com/ansible/docsite at some point in the past? 15:22:14 or was it another old repo that I don't know about? 15:23:11 Don Naro: It came from there, docsite repo 15:24:22 ok, thanks. I probably just didn't go far enough back in the logs. good to confirm that so thanks again. 15:24:25 Don Naro: https://github.com/ansible/docsite/pull/63 15:24:44 This PR ^ was when I changed it to what it is now 15:26:06 But the tower sitemaps never got deleted so people must still be landing there. 15:26:10 awesome. thanks for that. so it's as I expected and probably just need to ssh into the web server and replace that ansible-tower.html page (or nuke it and create a redirect). 15:27:06 Whatever makes sense, but we don't need people to keep going to that old page since the archives have the old versions of the tower docs. 15:27:24 indeed 15:27:53 just didn't want to make the change and then have it get reverted with some automatic update out there. 15:28:06 I need to get better at grepping through git logs 15:28:54 Don Naro, can you guide me into fixing that nuke and ssh you want to do so people don't need to keep going to that old page. 15:29:24 #info community execution environments. what is missing? this was a topic that was brought up at some previous meetings. there has been an update since that I thought would be relevant. 15:30:04 #info andersson007_ from the community team is working on https://github.com/ansible-community/community-team/issues/230 to make some improvements to the state of things with community ee's 15:30:59 \o/ 15:31:06 that's awesome! 15:31:07 Dule_Martins#0383: I'd be more than happy to but, unfortunately, I think access to the web server I mentioned is restricted to Red Hat 15:31:29 Ooops! Thanks for the info 15:31:55 maybe there is some other way though. I'd be open to sharing the steps and walking you through it if you're interesting. and - hopefully - we'll be opening up more of the publishing process soon. 15:32:08 Dule_Martins#0383: you're welcome! 15:32:17 Ok Don, I am 15:32:45 Always more than happy to get my hands dirty with docs issues 15:33:16 felixfontein: yeah I think it's a great initiative and wanted to share it. docs plays a major part in that epic so I imagine we'll have some contributor opportunities there soon 15:34:03 acozine: any updates on the cheatsheet from last week? 15:34:03 The community writer project board hasn't been update with docs issues for some time now 15:34:30 Don Naro: I havne't seen any cheatsheet PRs 15:34:41 Dule_Martins#0383: is that something you'd be interested in working on? 15:34:58 so, what if Don Naro we can add issue there for other member of this community to make their contribution. 15:35:18 Yes @acozine 15:36:20 Dule_Martins#0383: here's the ticket: https://github.com/ansible/ansible/issues/75509 15:36:58 Here's an example PR: https://github.com/ansible/ansible/pull/76655 15:37:02 Alright, let me go through it! 15:37:09 #link here is the ticket for doc issues to add command cheatsheets: https://github.com/ansible/ansible/issues/75509 15:37:18 I'm also interested acozine 15:37:32 fantastic! 15:37:56 indeed! that's great sutapa_b and Dule_Martins#0383 thank you both 15:37:59 here's hte docs page as it stands now: https://docs.ansible.com/ansible/latest/command_guide/cheatsheet.html 15:38:17 @sutapa_b we can do this together I guess 15:38:47 if someone has a link handy for the community docs board, I think I can add that issue to it 15:38:58 Dule_Martins#0383: sure we can 15:39:50 #link community writers project board https://github.com/orgs/ansible-community/projects/3 15:40:20 ooh, that's a lot of merged PRs . . . nice work, folks! 15:40:36 #link https://github.com/orgs/ansible-community/projects/3/views/1 15:41:17 On behave of the community writer I smile @acozine 15:42:14 #info the Steampunk project has added complete documentation for all versions of all Ansible Collections that exist on Ansible Galaxy! You can find it here: https://docs.steampunk.si/plugins/ 15:42:14 I added that issue to the community writers board 15:42:22 thanks acozine ! 15:42:28 I wasn't sure if I should mark it git branch required or not 15:42:48 it'll probably be easier in branches, but could be done on GitHub 15:43:05 You should add it @acozine 15:43:27 okay, done 15:45:02 #topic open floor 15:45:35 think it's time to open it up. anyone got something they want to share? or questions to ask? 15:46:07 Yap I do 15:46:14 about Ansiblefest 15:47:38 I'll try to answer what I can about Ansiblefest 15:48:32 Last year, we were given the chance to speak at the contributors for AnsibleFest, how about this year? will such happen? 15:50:07 yeah I remember that last year. it was really great. I don't have an agenda I can share with everything that is planned but Ansiblefest is combined with Red Hat Summit and is taking place next week. 15:50:27 cybette can probably tell us more 15:50:27 I'm sure there definitely will be opportunities at other Ansible contributor summits though 15:50:45 * the contributors summit for AnsibleFest, 15:51:15 Cool, thanks for headups 15:51:34 I don't think there will be a contributor summit, I'm not sure when the next Contrib Summit will be 15:51:47 I meant, there won't be one at Fest/Summit 15:51:54 there will be more in future, but not next week 15:51:56 oh, why? 15:52:06 ah, it's already next week? 15:52:21 yeah, then it's unlikely there is one :) 15:52:22 Unfortunately this time it's fully in-person, and it's Ansible Community Day as part of Red Hat Summit / AnsibleFest. We plan on having additional Ansible Contributor Summits later in the year where online participation is possible. 15:52:50 (since we had one earlier this year in February) 15:53:22 will recordings be available later on? 15:53:30 (and is there a schedule somewhere what will happen at it?) 15:53:52 Schedule is here https://hackmd.io/@ansible-community/ACD2023-Boston 15:54:00 I expect there will be fewer Ansible folks there - when Fest was a standalone conference everyone was there for Ansible, but at Summit there will be a lot of people who haven't used Ansible before 15:54:18 We will have at least audio recording and we plan to share that with slides. 15:54:21 plus it's earlier than the usual date (Fest traditionally was in September/October; Summit is in May) 15:55:00 yeah the schedule was quite challenging to work with 15:55:32 however, it gives us more flexibility to do something more community focused in second half of the year, so please stay tuned :) 15:55:53 thanks cybette 15:55:58 Cool, cybette (@_discord_697498573712916482:ansible.im) 15:57:56 ok I think we can probably call it there. this was a nice meeting with a lot of chat so thanks to everyone for coming along. 15:58:03 #endmeeting