Continuous Delivery Foundation Best Practices Special Interest Group, 26 Jul 2023

Previous Meeting

Next Meeting

⏯

youtube image

►

From YouTube: Best Practices SIG - July 26, 2023

Description

For more Continuous Delivery Foundation content, check out our blog: https://cd.foundation/blog/

A

Well, it doesn't look like anyone else is uh going to be joining us, so uh let's just have a a quick chat about uh where we are thus far with the uh the translation stuff.

B

A

May have seen that uh uh We've committed a few changes into the uh um the doxy upgrade branch on the site repository this week.

A

um I hope for the uh we have got uh to position where everything is now working. ah Here's Tara I was just pause and let her get signed in.

A

No, we've lost her again.

C

uh This money I saw I saw that it is starting to to upgrade uh the website. So the doxy, the industry build yep, that's correct, hi Tara. Can you hear us.

D

uh Hello, sorry trying to uh we try to connect from a different setup and uh we're just having all kinds of problems.

C

It's okay! How.

A

D

Everyone today.

A

I'm happy with this.

D

A

So I was just starting to say: um we've been making some progress on the um on the doxy upgrade.

D

Yes uh and I- sorry should have done all this yesterday and I did not um still having problems.

D

um So I realized uh I had failed to notice. I. Think I mentioned this in channel that the windows Linux subsystem versions by default are not up to date, which was causing some of my problems. um I wanted to confirm, uh with which version? Do you have it's just absolute latest like point eight, whatever.

A

So uh if you take a look in in the notes for today's meeting, I've put all the versions in there.

D

Perfect having to sign into hack MD from this machine sign in no stop.

A

So I can I can read active if it's easier.

D

B

D

C

C

Is it you go, you have me, we need to upgrade uh all the on the call so where.

A

You go on DocuSign.

C

A

So you you need, um in order to run the the latest version of uh doxy, uh which is uh version 0.7.1, as a module.

D

A

Need Hugo, 0.115.

A

And uh in order to run that you need Go version, 1.20.

A

D

Oh man, yeah okay, way behind all right, so my Hope was- and thank you Terry for stepping up on this, because I was running so slow, the internet. My goal is to validate your changes um and then we can merge them into.

D

Main line and then update the l10n branch, um so I'll be working on that.

A

It might might be easier to just create a PR from from the upgrade Branch onto Main, and then that should create a preview.

D

Oh right, I forgot about the previews I forgot about the previous user are correct. We should do that.

D

Let's do that: okay, right now.

A

Looks like we might need to tweak the config on on our setup, because you should be able to get previews on branches as well and uh we're we're not getting that. In fact, it doesn't seem to do any checks on branches at the moment. So that must be something about the next.

D

A

D

All right: well, that's the beauty of having a working pull request. um We have a workaround.

D

The do we have, let's see, upgrade.

D

Now we have a bunch of tickets that.

D

I've, oh man would be cool if we could associate the Pete the pr with the tickets.

A

D

Here we go link yeah, so once we create the pull request, we can.

E

D

How's everyone's weekend.

C

Oh good good IES and uh in the Augusta I'm gonna take my my vacation so meet August. So now we are running to to complete all uh all the stuff before I leave.

B

D

B

D

C

D

Looking up some.

A

So just uh wanted to talk through a few bits that we need to be mindful of um now we're using the new setup.

A

So um the uh the config terminal file uh has now changed to hugo.com.

A

uh It's mostly the same structure, um but there are a few changes, so uh the languages section is now a bit more deeply nested. They changed the uh the way this was configured.

A

So when we add a new language as a translation, we need to create uh a section for it and specify its details, uh but um the description has now moved into a nested parameters, value which uh it was at the top level before uh and that throws an error.

A

uh And then, once you see, the site running uh you'll see that we have a uh a drop down language selector in the menu now, and the content of that is specified by this language name tag.

A

So we might want to do the the translated local language name in in there so that it shows up in the appropriate language in the in that drop down.

A

uh Then also in this config file, we now have a new um modules section, and this is where you configure additional plugins uh and these get mounted into the file system for the application stack.

A

So the stuff that's in here and under uh Hugo and and Doxie, um is the configuration for the doxy plugin. So, whereas previously we actually had a uh a physical instance of the doxy theme under the themes folder, um this now exists as a separate asset that gets imported.

A

So this should um be much easier to keep up to date, because it will now just inherit the latest version when, whenever we start the server.

D

Isn't it such a terrify, a a a terribly satisfying thing when you have a pull request with all of those deletes, yeah I love those clean.

A

It up the the challenge that we had is that actually um we had added uh a bunch of sections to the base, doxy theme, um so that's why nothing would render correctly initially so I've had to uh override that and that now lives in in the layouts folder um and so for each of our new category sections.

A

uh We have a corresponding layout now, in our case, they're they're, all exactly the same at the moment, because all of our pages are structured the same, but in theory, if we wanted to um to vary these, we could uh we could make say the resources sections look a bit different to the other sections.

A

um I have also added some short code: extensions to Hugo, um because uh the the rendering has changed quite a bit um in the past, 50 or so versions that we've skipped, and so some of our Pages were no longer rendering the way we want them to um so. I've just made some little utility things to allow us to uh to tweak the layout easily.

A

um Going back to this uh config file, there's a new section here that we need to look at um so what we can do now is actually um modify the uh the way things get mounted in the file system for Hugo, uh and we can do that hierarchically.

A

So what that means is you can effectively Mount the default English map of the site underneath any of the translations, so.

D

The thing that you were talking about before from the CD events- kind of yeah, okay, cool yeah.

A

D

A

Means that you, when, when you've only got a partial translation, you'll still have the full site, but some of it will be in English, and some of it will be in the translated language.

A

Now you do have to do that explicitly for each language.

A

um So this this is the the default name for English, and then uh you need to add one for for each additional language uh in order to make that work.

A

uh I think the rest of this is still pretty much, as was I've tied it up a little bit. There were some configuration things in here from style, Market languages that we weren't using anymore.

D

All right, the net Supply deploy broke.

C

Is there somewhere here we can make it drop down to choose the language.

D

I think that should show up by default now right.

A

Yeah, let me change.

A

This work and I think it's through on it.

C

Oh wow, you lose, he looks very it's different. It's different, looking yeah.

A

C

A

Is different and the the the colors have changed slightly? um They seem to have made some changes to uh to the way they're doing the the color handling, um but you've got this drop down menu. Now that allows you to switch across now uh and that seems to have broken um yeah.

D

A

A

Okay, that's weird.

D

It's failing in a very basic way that makes me wonder if there's something we have to do on the network by side.

C

C

Excellent these 2007 here, when you see a close of the logo, is Transit.

A

Yeah, um but this page should have a translation for it, um so uh something about that. Remapping is not working um or there's a race condition because I had it working when I tested it and it's Now not working again.

A

Excellent: hey fine for anyone who tries.

D

To claim that you don't need proper doc teams, they need to shut up yeah.

D

This stuff's hard.

E

C

Next tip I also I will play the docker file for those need to to use Docker to to develop so.

C

Mine is when the upgrade gonna be uh match on the main main branch. Are we I.

D

Mean you could you could add the doctor file update to the upgrade branch in the meantime if you wanted to test it, but it looks like there's a number of things that.

C

Are gonna all right I'm, not on my uh on my personal computer.

D

Yeah no rush, yeah.

A

I've I've removed the the here the.

C

Mapping it looks like you're here when you choose Spanish, all the menu is not showing up.

A

Yeah, that's that's correct. This is what happens if you don't have that um that remapping uh of the English site, underneath um so now, if I switch to English you'll, get the English page and uh the whole menu stack. But if you switch to Spanish, we've only got um the about page um and it looks like.

B

D

B

A

Update this because um I've had to make some changes to the to the whole site, so we'll need to um move those across to the translations as well.

D

So I think I know I'm here I go.

D

So something in that we have to figure out something in the netlify. Oh I see it's hard coded to look under themes doxy.

D

um What would that be?.

E

D

Sure there's something here too.

A

Which file are you looking at.

D

Oh um so I, uh if you look.

D

Drop the link here in a single chat.

D

um So the the build was kicked off. It's it's hard-coded to go into themes, doxy, um there's some tweaks somewhere. We need to find to fix that.

D

A

D

It's glamorous.

A

Yeah, we we don't need the to get submodule stuff either yeah.

D

So there's a I'm looking for.

A

So we've got a build script somewhere then yeah.

D

D

D

E

D

Looking at the mapify app connected to it,.

A

Have you found the build settings.

D

Yeah I'm looking.

A

So um if you go in the net, if I, config, um sort of best practices, CD Foundation, there's a side menu that says, site configuration and there's a sub menu which is build and deploy continuous deployment.

A

And it looks like there's a configure for.

D

No, no wait. Hang on I'm in the netlify.

D

I'm gonna do a quick share screen Terry.

A

Yeah, just a sec.

A

D

Oh I, see you're coming out from the I was looking at it from the GitHub you're coming at it from the Netflix site.

A

D

I was in the wrong location.

A

uh So I'm just gonna copy that and keep a copy of it somewhere.

D

A

uh I think we should be able to just change that to be Hugo.

A

C

A

In the it starts in the in the root directory and changes down which we don't need, so we don't need that bit um and then all the rest of the app command is setting up the git sub modules uh which we no longer have, and then it's just going back up again, which we don't need because we can go down. So it should just be that yep.

C

Let's go let's.

D

Try this again once more with feeling, as they say,.

A

Well, I see if I can.

C

You need to specify the branch.

D

It should okay hang on it, shouldn't no.

C

It's not a good proof, see. Okay, there.

A

We go I'm free, I'm, really trying the the branch that failed.

D

That looks promising.

B

C

There we go there.

D

D

Okay, so we still have so he switched to Spanish, and this we'll still have the the mount issue.

A

B

D

Wait, it worked, but it looks better. Oh.

A

No, no, it's uh it's it's doing everything, but it's overriding the Spanish with the English. Oh.

D

Oh I see the application error down below. Okay, ah all right, well, progress.

A

June, so let me push my changes um because I I've.

A

Just patched that out so.

C

Guys free to use- or they need a license near to buy something on it.

A

uh All of this is free to use now.

D

um I am having a work thing: I'm gonna have to jump um I will um I will follow up on on any updates on my site in Slack.

A

um And believe me, no problem leave.

D

Me any requests that you may have in slack as well.

A

Right, hopefully, that should deploy again with just the just the translations, so it should then be um readable and I'll look and see. If there's something special, we need to get do to get that working properly. Yeah.

D

A

But if everybody could take a look through the site and see if you find any major rendering issues yeah.

D

As soon as I can get my kugo setup fixed, that was the next thing I was going to be working on, is just starting to poke through everything all right.

B

D

You Terry talk to you later.