15:01:23 <oranod> #startmeeting Documentation Working Group aka DaWGs
15:01:24 <zodbot> Meeting started Tue May 23 15:01:23 2023 UTC.
15:01:24 <zodbot> This meeting is logged and archived in a public location.
15:01:24 <zodbot> The chair is oranod. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
15:01:24 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
15:01:24 <zodbot> The meeting name has been set to 'documentation_working_group_aka_dawgs'
15:01:31 <oranod> @room Meeting time! Who is here to talk the docs?
15:01:40 <oranod> 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 <oranod> Welcome to any new joiners.
15:01:47 <oranod> 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 <oranod> 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 <oranod> #info meeting agenda at https://github.com/ansible/community/issues/678#issuecomment-1549686517
15:02:06 <oranod> whoops.
15:02:19 <oranod> #info here is the correct meeting agenda (kind of light today): https://github.com/ansible/community/issues/678#issuecomment-1559594316
15:02:22 <sutapa_b[m]> o/
15:02:33 <oranod> #chair sutapa_b
15:02:33 <zodbot> Current chairs: oranod sutapa_b
15:03:00 <oranod> I think it's going to be a quiet one today with lots of folks at AnsibleFest and RH Summit
15:03:17 <oranod> but we can still catch up and have some docs chat
15:04:09 <oranod> #topics Updates and Action Items
15:04:21 <oranod> s/topics/topic/
15:05:40 <oranod> #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 <oranod> 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 <oranod> just merged a couple PRs for the ecosystem page and the platform and have another on the way for platform translations
15:08:37 <oranod> 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 <sutapa_b[m]> yes ! can you please show me how to do that ?
15:09:49 <oranod> 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 <oranod> so I'm happy to hang out here and just go over it unless someone objects
15:10:40 <sutapa_b[m]> No objection from me.😀
15:10:50 <oranod> ok so you can look at this commit as an example: https://github.com/ansible/jinja-docsite/commit/5ac2234756e2ef2003a14060916d07fcf891d6c3
15:12:28 <oranod> 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 <oranod> 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 <TVo[m]> Hey! o/ sorry I'm late
15:14:44 <oranod> 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 <oranod> #chair TVo
15:14:53 <zodbot> Current chairs: TVo oranod sutapa_b
15:18:26 <oranod> 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 <oranod> 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 <oranod> 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 <TVo[m]> Oh good
15:20:37 <TVo[m]> Yanis has also made it really easy already for 4.3
15:20:52 <TVo[m]> being "streamless"
15:21:25 <oranod> 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 <oranod> it's something I probably should have done at the start tbh
15:22:40 <sutapa_b[m]> Yes I'm looking into the commit.Not completely clear but trying.
15:23:18 <sutapa_b[m]> but please ping me for review.
15:23:26 <oranod> will do!
15:24:30 <oranod> 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 <oranod> 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 <sutapa_b[m]> The PR has been merged but now I'm wondering what should be the next step.
15:26:24 <sutapa_b[m]> Do you have any issue in mind?
15:28:09 <oranod> I was referring to this one (looks like it is still open): https://github.com/ansible/awx-operator/pull/1363
15:29:05 <oranod> looks like it's failing on a lint error or something
15:29:13 <sutapa_b[m]> I'll review this today.
15:29:49 <oranod> 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 <sutapa_b[m]> okay
15:32:16 <oranod> great, I just added a comment. hopefully we'll get some help with that CI failure.
15:32:52 <oranod> 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 <oranod> #link https://github.com/orgs/ansible-community/projects/3/views/1?layout=board
15:34:13 <oranod> 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 <oranod> 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 <oranod> probably need to wait for samccann next week before diving into all that though
15:37:31 <oranod> how about we go for a brief open floor and then call it a day if nobody else has anything?
15:37:35 <oranod> #topic Open Floor
15:39:37 <oranod> 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 <oranod> #endmeeting