Kubernetes SIG Docs, 4 Apr 2022

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: K8S SIG Docs Localization Meeting for 20220404

Description

For more info see https://git.k8s.io/community/sig-docs

A

Hi everyone I'd like to welcome all of you to the April 4th 2022 Sig Doc's localization work group meeting. uh This meeting is being recorded and seeing um uh Cloud native Computing Foundation code of conduct rules are in effect, so please all be nice to each other and uh thank you all for attending. uh It doesn't look like we haven't anyone new. We have veterans here, uh Soko and Abby. So let me go look at the agenda uh and it has been recorded So.

A

Other people could go back and and watch this if they need to do um Okay. So um Abby did you put this first item on about Docker shim removal, or did that some was that someone we don't know? Yes,.

B

That was me sorry, I forgot to put my name there.

C

B

Just wanted to put out um a warning but advance notice uh to everyone in on localization teams that there will be possibly higher than normal um docs changes in this release in the upcoming release because of the docker shim removal project. So it touches a lot of pieces of documentation.

B

um So just wanted to put that out here, make a special note to it in this community. um So folks kind of had a little more advanced notice about it and I put in some links in the agenda more information about the docker stream removal project, and then there is a tracking board.

B

um uh If you are interested in what issues nprs there were for this release.

A

Okay, fantastic and I'm on PR Wrangler duty this week, so just great news to hear that we're going to have just a increase in PR as a lucky me I'm, looking forward to that, um maybe we won't all hit this week. um Okay, great um anything else, Abby.

B

That's it for me: I'll try to also post this in the in the slack channels um later as well. So folks know about it too. Okay,.

A

Fantastic um all right: well, thanks Debbie for that update, uh Soko you're up next on the agenda. Okay,.

C

uh We have decided to recommend a best practice to include both Latin and the table. Scripts uh in the uh uh languages are fantastic and uh there's an inconsistency between languages.

C

So uh there was an action. I came to me, uh which is to update localization guides, to mention this new recommendation so.

B

C

Opened an issue to.

B

C

I understood correctly and then based on the discussion in the issue, I opened up here, fantastic to update to localization type. So you can check the tier.

C

uh Yeah, it is uh very similar with our recommendation and during the discussion in issue team actually suggested additional option.

C

A

C

Yeah configure QR, which is a language name, that's in script, so I included it in the pr. So maybe we can quickly see the here yeah.

A

Would you mind sharing it.

C

A

Yeah, why don't you go and show it yeah.

C

Can you see the screen.

A

C

Okay, this one is a character need this one is a shoe and I collected the issues in our meeting and very nice I suggested that this kind of phone language name uh their relative in English character and English, YouTube English right and here Tim suggested uh this kind of new option so that we can somehow retain or use uh I mean access to the Latin script through this option.

C

Option variable.

C

So this one is the pier I seem pretty modified like this. It is cut, it is included in the kite, so I added these two examples, which includes uh uh German.

C

uh They keep a character and English alphabet, and that is script, but uh actually I have a question regarding this one: I'm not familiar with the Latin script and English alphabet I think they are nothing or should I use this part in Latin script, and this one is also Latin script.

A

So so I'm trying to understand it. It looks like it's in some ways the the language name Latin script is is, is, is, is sort of half a duplicate right, so it it carries so before we were putting both values in a single attribute, correct. We were putting.

C

A

Language script and and then the Latin script. In the same that and.

C

The same value and.

A

It looks like you're kind of doing that here, so language name has sort of the Native script Deutsche and then German and parentheses, and then you added language name: Latin script equals German.

D

A

Does it help to put it in its own own attribute? There must must be an advantage that I didn't didn't understand.

C

uh I also, not quite sure, but I, think uh this language name that if script can be uh or variable, okay.

A

C

Can be uh build uh can be used during the site build process, so maybe we can put like short codes. We can use it. Okay,.

A

C

Is optional, but if we put uh we, if we write localization things like this, then one day, if we need it, we can use it. Okay,.

A

Yeah I think I understand now I think I understand the value that shows up in the menu is still going to be language name right and you have to put the native the native name and the script name in it.

A

um But I think what the suggestion was. There might be places in the future where we're going to want to be able to leverage the Latin name, and so, if we store that value optionally optionally later in the future, when we render certain types of content, we might rely on that value and use. The Latin name did I understand that right, Soco, yeah, I I understood the internet, okay. So it's it's it's optional, metadata that we think will be used in the future.

A

That's how I interpret it. Yeah.

C

um So Abigail.

A

Does that make sense.

A

I can't hear you I.

B

Mean yes, yes, um that does make sense. I was just wondering if it um because you're just trying to think about whether, uh like doing it right now with the um both of them together in the parentheses in language name, it will show up, because the site is set up default to read that and display that.

C

B

The drop down um so I guess it is a I guess repetitive, but it's set up to see that right now. So, if we wanted to, have it be less repetitive, we'd have to fix the. How Hugo presents that information to then also show the in the parentheses. The second variable you know what I mean right.

A

But that may be, and if I'm Hugo, maybe they're like well, that's kind of non-standard I mean we'd have to have a Hugo contributor, yeah I.

B

Was looking into this a little bit and we'd have to go in and and and and fix how that drop down is being generated right.

A

B

It would just be more work, so I'm not sure like, like you said it is a little bit of duplication, but I don't know if it's worth the effort to do the extra work there. So I think that this. This is a good way to do it, um so that we can also access that data whenever we need it going down the road right.

A

My guess is: there'll be some place in our content, where we would like the the the Latin script version of the name, and this this gives the person the ability to find that metadata. If that.

B

A

Yeah: okay, very cool, um okay,.

C

uh Yeah, that's all for the this update localization guide after this localization guys has been uh approved and uh we are going to recommend other teams to use this kind of decide right. Yeah,.

B

C

It looks like similar, which include latification.

A

A

um Yeah we'll start doing, the word on I did get the word out to um the Russian team and the Polish team. I haven't heard back um for obvious reasons. I did not feel comfortable, bothering the Ukraine team at this time so I figured. They could wait, obviously reasons um but I I I I I will also help follow up, um we'll have to see how active some of those communities are, um but yeah. We could ideally get the word out and then they could all look that way.

A

So right friends, say would would be French and Italiano Italian I.

C

A

It's most I think critical for the ones that are not a native Latin script.

A

um My guess is, my guess is most people know Deutsch is German Espanola Spanish, um my guess is we don't have to change those but am I being too american-centric by thinking that way, uh a welcome Rolf by the way, welcome and and Abby. But let me know your thoughts if you feel I'm being a ugly American by thinking that way. Let me know foreign.

D

If I understand the issue correctly, the issue is that some languages have their Latin script, approximation and others don't.

A

Well, yeah there's certainly some that um you know unless you know the native language script you're not going to know which one it is and then there's a couple that I could pretty much figure out because you know I I've, always known that Deutsch is German and espanol is Spanish.

A

um But but maybe that's just an american-centric view. I don't know um so.

D

A

I should ask Soco, I mean Soko. If you saw espanol, did you know that was Spanish or did you not know that was Spanish or if you saw Deutsche did you know that was German.

C

C

You know maybe the candle couldn't on issue and core uh localization teams or purpose you.

A

Can decide I think.

C

We can get uh the upper west list from uh tracing the uh the list documentation. I I saw during the release process. There is we open an issue to trace the documentation, release and and then release issue uh many localization team of progress applied May. The reply in that.

B

C

So maybe we can find them.

A

Yeah we can find them and then we'll we'll get their input on whether they feel the extra script is necessary on theirs or not. I think I think we can certainly make a case for Polish Russian Ukrainian. It really is necessary and and obviously some of the other ones that it would seem necessary, have already added it um and then we'll just figure out. um You know whether the ones that are kind of- maybe yes, maybe no I, guess their team can decide.

A

C

That make sense.

A

To everyone go ahead: roll.

D

I was going to say that there are a couple of approaches to this. um What is the current approach, which is kind of a English language, Centric um and the reason, obviously, this is eight raised just because that might not be appropriate. The second is that the uh annotation could be in could be generated according to the user's native language.

D

So if you're looking at the website in um let's say French, it will use the French equivalents on the right hand, side or The, annotation and The annotation could be done two ways it could be in line like it is currently or it could be actually a tooltip, a hover over a tooltip and a third.

D

A third approach that would be uh agnostic in terms of the viewer's language would be to put the iso language code like JP or de or um UK, or en uh so on and so forth, and um so that using the iso code in all cases would be the most neutral. It would be readable to most users who have a familiarity with those languages.

A

Yeah I wonder how many people, though, really know the iso code right that that might be sort of a programmer-centric kind of view true, um but go ahead.

B

Abby I would just say if, whatever, if we're doing it for one like one and it's a recommendation to have it, we should probably at least start off by having all of them like, if possible.

B

um Have it have it all be similar down.

D

The line and then we.

B

Can we can ask for feedback to see if it does make sense to people um and kind of iterate that way.

A

Yeah, let's see how it looks if we get them all up right, you know get them all. Like the first three Micah says it's going to be a crisp clean, look uh very consistent, so I think we I think you're right, Abby I think we should see if we can get that done.

D

Can I I? Yes just toss in one more thing: uh this is off topic, but um your name is right.

A

D

Sorry is your name: it's.

D

Above your where it says, oh actually, what is your name my.

A

Branch opal I'm. Sorry, oh.

D

A

Apologies yeah. You joined a little late, but I'm I'm.

D

A

And uh yeah I chair the group.

D

So I wanted to say about joining late. What happened is that I opened the meeting invitation and I clicked the first uh meeting link, which says join with Google, meet and I sort of sat there and scratched my head and waited and asked you know it's an empty meeting. So I was wondering if we could remove the Google meet from the meeting invitation since that's not being used for video conferencing. Oh.

A

My goodness I did not know that I am so sorry um uh yeah. So you clicked on the what the calendar notice is that, where you clicked.

D

Yes, I have the calendar, notice and I went into that and the first item it says, join with Google me and, oh, my goodness, that's misdirecting people away from noticing the the zoom link further down in the same invitation in the same uh calendar item. Okay,.

A

Yeah um I will check with the the leads that do the calendar notices and see if we can get that removed.

A

My apologies for that uh that that's yeah, that's not good, because we do want you to be able to join and find a meeting uh so um yeah we try and keep it in the dock and and and, like you said down below, but um yeah, we'll we'll look into that and see if we get that removed. Okay,.

D

A

All right cool glad you were still able to find us, though, so that's good yeah.

D

At some point, I was like I wonder if there's another link down there and I'm sure enough there. It was perfect.

A

Okay, thank you um all right. Well, Soko any more on this topic. um I think I think we kind of understand our action items we'll we'll push to to try and have both in there and I guess. We can push to also add the extra attribute right. The language name, Latin script, um so we'll try and get the word out on that one too um wow.

A

Okay, and so you know I, guess we'll Circle. We've got to figure out how to reach all the teams, but we'll do that.

A

um Okay, um ready for the next topic, Soco.

C

uh Yeah, uh there's top videos about Korean localization team, update right, uh actually I'm I'm dating Korean localization team in seagull dogs, local localization team. We use development branch and we keep changing the Prince and current branch is uh one two three ko2 and this development Branch for Korean localization about to be finished.

C

Okay, so also we are using Milestone. We create this development branch and we announce Korean localization issue using issue. We announced our new branch and uh kind of deadline and extra so that other Korean localization contributors can join this issue and work for this branch and then second important issue is updating outdated, Korean content.

C

So we keep press uh what which documents Source document from English is intangible. During our localization job, as you can see, there are lots of uh difference.

C

So we are. We try to finish this two issue in this branch, so we are going to finish this one and I know uh we are. uh We are expecting the new new minority release soon before the minor release. We are going to merge our Branch to Main Branch soon.

C

So it is information to you uh so I. You know I explained a little bit. uh We have, uh we are keep tracing outage, the Korean Parts contents and then uh in case of Korean localization team.

C

We already localized more than 400 document documents and as I know, but actually we have more than one thousand documents in English, so uh it is less than half, but uh it is quite uh many parts for local uh Korean localization team, considering our members number of members, so we are Keen looking a way to reduce this uh overall workload to us, uh but uh we don't have a nice idea, yet uh it is working in progress and thinking about power based comparison. We are currently comparing the uh outdated try to keep Trace outfit.

C

The content based on French comparison using Keep Deep, but we are thinking about uh power based comparison, but uh it is still working in progress. So I don't have I cannot stay hotter, so it is also information to you. If you have any nice idea to reduce this kind of job, then please let Korean team knows and finally write. 10 is we applied uh per uh contribution mentorship program hosted by naipa? It is a national I.T industry promotion agency in South Korea.

C

So there is a program and we applied for that, so we expect together new contributors.

C

uh Actually, there are lots of uh students who are uh who hope to understand the open source project and learn how to contribute to open source project I. We plan to bring them to Korean localization contribution, so maybe in next to our localization meeting I will bring them and um interest introduce them to all of us. So that's all right. Okay! Is there any question regarding the speeches.

A

No, this is excellent and I hope uh I. Hope you get your mentorship program approved.

A

Thank you. Yes, um I I did have a thought uh going back to the other topic. um The config.toml file actually isn't in the sort of local native language right. It's it's it's it's! It's it's more above correct than the is that correct. If, if I'm thinking so I'm wondering one of us could go update that file and then we could get it, we could then review and improve it and.

C

Then so the computer map card is here in the section.

A

Right so they're all located here right.

C

So equally updates expire and we need to. We need to get approval from so.

A

C

Yeah from uh English or purpose, not the localization teams.

A

Right so you know what I can do is I can submit the pr and go update them and then it'll be you know and then I'll reference, your issue I can reference your issue um and and and then we can submit it to the team unless there's someone here that would like this very easy, low fruit PR, although I don't want anybody to get yelled at, and somebody say why did you change ours? Who are you so so, if anybody's nervous about that um I'm, the type of person that you know can take a beating.

A

This meal's been whipped a thousand times so I I, don't mind submitting that PR. But but um it looks like it's a pretty low fruit, one you just gotta, Google and figure it out, um ABIA Rolf any interest in doing it or are you like yeah, you do it Brad. Let me know.

B

I'm I'm happy to help if it's not, if you don't have, if you, if you, if you, if you're looking for someone to take it on as well. So it's.

A

um I I think it's a really good low fruit one. If that's okay right, you just.

D

A

In and up you know you gotta, Google and figure out which ones that are, if you don't know, um but the the oh, the content directory kind of gives it away anyway. So if you scroll up you look at the content, dur value are you, then you know it's Russia yep, um so so yeah. If, if you would like a low fruit, one um um I I would say, go, go ahead and add it and we'll do it.

A

Just like Soko said with the parentheses and then we can submit it to to Natalie or Jim Angel and and then the the burden of approving this change and will be on them on.

B

Them yes, perfect: okay, yeah.

A

Yeah I stick great idea: all right, cool, wonderful, um so I'll, update um and I'll, add I'll. Add to the uh that Abby took an action item to to go update the the file.

B

A

um Well, I think that's all of our topics here, um so we're at open Agenda time are there any other topics that people wanted to cover yeah well, I.

D

Just wanted to ask I'm new to the localization team, or to this meeting and I'd like to uh do some onboarding. Can you point me to the appropriate resources for that.

A

uh Yeah, can you slack me and I will get you everything we. We have wonderful um content uh that I'll happily point you to and then.

C

You know we have.

A

Slack channels was there a particular language. You were interested in.

D

French, in particular, French.

A

Okay, so, and even French has its own localization channel, so I, um if you could just uh slack me, I, will get you everything. Okay,.

D

Perfect I'll do that right.

A

Away all right, um yeah and then, if you add your name to the participant list or I, can yeah okay.

D

Good I don't have edit writes for that document. The agenda document that's.

A

Okay, someone's trying to add it, you wanna is there a way to get your your full last name or so.

D

Yeah Slack I've, just uh I've, just select you on the sick, docs localizations thread. Oh.

A

A

uh Was under reply, uh roll okay found it found it found it. Okay,.

A

Let me add this wonderful.

A

Oh, what did I do like that?.

D

But we will fix that. Let's see Ctrl shift V.

A

D

A

That would have been a better way to do it. huh Thank.

D

A

I learned something new over me: control Shifty, oh I'll! Do it like that again, not like it, but that's: okay, I can I promise. I can fix this I'm uh how's that better I mess up how the agenda Works. Let's see yes, I did.

A

Oh somebody fixed it for me already somebody's very nice and helpful. Thank you.

D

And I think Abigail you'll repair your name on that.

A

Oh, oh, look at that how's that thank you. We got to the next extra last name to roll by.

D

My name, my last name's already long enough, I.

A

Know loogie hegware McCarthy. It's.

C

A

That would have been quite long.

D

A

Oh yeah, um yeah I, see you now on slack and I will get you the details, um all the wonderful details and just just come to us. If you have any questions, we have very good onboarding documents.

D

A

D

A

The new contributor, so thank you: okay,.

D

A

um Anything else for today.

D

A

Okay, well um I'm gonna update the agenda to show that Abby's gonna take the uh the action item and um Rolf I will send you the details right after this meeting.

D

Terrific nice to meet you all.

A

Yes, nice to meet you, and, and thank you, everyone for participating in our meeting. Thank you. Okay, all right, bye, bye, bye, bye,.

D

A