15:01:23 #startmeeting Documentation Working Group aka DaWGs 15:01:24 Meeting started Tue May 23 15:01:23 2023 UTC. 15:01:24 This meeting is logged and archived in a public location. 15:01:24 The chair is oranod. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 15:01:24 Useful Commands: #action #agreed #halp #info #idea #link #topic. 15:01:24 The meeting name has been set to 'documentation_working_group_aka_dawgs' 15:01:31 @room Meeting time! Who is here to talk the docs? 15:01:40 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:47 Welcome to any new joiners. 15:01:47 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:47 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:47 #info meeting agenda at https://github.com/ansible/community/issues/678#issuecomment-1549686517 15:02:06 whoops. 15:02:19 #info here is the correct meeting agenda (kind of light today): https://github.com/ansible/community/issues/678#issuecomment-1559594316 15:02:22 o/ 15:02:33 #chair sutapa_b 15:02:33 Current chairs: oranod sutapa_b 15:03:00 I think it's going to be a quiet one today with lots of folks at AnsibleFest and RH Summit 15:03:17 but we can still catch up and have some docs chat 15:04:09 #topics Updates and Action Items 15:04:21 s/topics/topic/ 15:05:40 #info updates to the docsite repo have been taking place to simplify some of the html pages https://github.com/ansible/jinja-docsite 15:06:50 I've been going back through the docsite repo that holds the HTML pages for docs.ansible.com and trying to simplify them with better jinja templating 15:07:27 just merged a couple PRs for the ecosystem page and the platform and have another on the way for platform translations 15:08:37 if anyone is interested and wants to have a go, let me know. it'd be great to make some more improvements there. 15:09:13 yes ! can you please show me how to do that ? 15:09:49 yeah, for sure. I can show you with a recent commit while we chat. I don't really have a ton of stuff for the agenda today anyway. 15:10:10 so I'm happy to hang out here and just go over it unless someone objects 15:10:40 No objection from me.😀 15:10:50 ok so you can look at this commit as an example: https://github.com/ansible/jinja-docsite/commit/5ac2234756e2ef2003a14060916d07fcf891d6c3 15:12:28 if you look in the build.py file you can see that it is loading data from a bunch of yaml files with keys that have values that are either a string of text or a link 15:14:10 the html pages have been loading values from those yaml files in a really inefficient way, where each key is hardcoded into a div 15:14:12 Hey! o/ sorry I'm late 15:14:44 hey TVo no worries at all. glad you're here, we're just hanging out and talking about the jinja docsite and whatever else folks have got 15:14:53 #chair TVo 15:14:53 Current chairs: TVo oranod sutapa_b 15:18:26 sutapa_b: the idea to simplify the HTML pages is to restructure those yaml files a little so we can loop over the keys and generate divs and other html elements for them 15:19:12 it just makes the HTML pages a lot smaller and means you really only need to update the yaml files in the data folder if you want to add stuff 15:19:52 TVo: I'm actually working on the controller translation pages now and it'll be a lot easier when we need to do what we did for 4.2.2 recently 15:20:16 Oh good 15:20:37 Yanis has also made it really easy already for 4.3 15:20:52 being "streamless" 15:21:25 sutapa_b: if you like I can ping you for a review on this PR I'm working on and you can take a look at that. then I can maybe create some additional issues that describe what to do a little more clearly. would love to have some help so thanks again for offering. 15:21:49 it's something I probably should have done at the start tbh 15:22:40 Yes I'm looking into the commit.Not completely clear but trying. 15:23:18 but please ping me for review. 15:23:26 will do! 15:24:30 sutapa_b: do you mind me asking how that AWX Operator doc effort is going? is there anything we need to do to get that moving? 15:24:56 not sure what the status is there really. I know you and samccann were working together on that but she's been away recently. 15:25:50 The PR has been merged but now I'm wondering what should be the next step. 15:26:24 Do you have any issue in mind? 15:28:09 I was referring to this one (looks like it is still open): https://github.com/ansible/awx-operator/pull/1363 15:29:05 looks like it's failing on a lint error or something 15:29:13 I'll review this today. 15:29:49 sure, I'll try and ping someone in the PR for help with that molecule error and try to get it moving too 15:30:51 okay 15:32:16 great, I just added a comment. hopefully we'll get some help with that CI failure. 15:32:52 as for the next steps, that kind of ties in with something I was thinking about from last week. adding more issues to the Help Wanted section in the writer's board. 15:33:05 #link https://github.com/orgs/ansible-community/projects/3/views/1?layout=board 15:34:13 hmm. and now that I look at that board I see the checklist issue is still in the backlog instead of in progress. 15:35:30 but maybe we could also define some additional AWX Operator issues on that board once that scaffolding PR gets merged so we can build on to it 15:35:52 probably need to wait for samccann next week before diving into all that though 15:37:31 how about we go for a brief open floor and then call it a day if nobody else has anything? 15:37:35 #topic Open Floor 15:39:37 ok, since most of the usual folks are probably at AnsibleFest and RH Summit this week I think we can end it here 15:39:42 #endmeeting