Jenkins Documentation Office Hours, 17 Apr 2019

Previous Meeting

⏯

youtube image

►

From YouTube: Google Season of Docs. Sync-up and planning

Description

First meeting for Google Season of Docs in Jenkins. Agenda: https://docs.google.com/document/d/15emWbz_WbL_8LyLicUVEBMNjYT9jQDeZTO0pC7m2b0A/edit#heading=h.87thaqf6drf0

A

Delighteth, if you here for this initial organization, organizing meeting for google season of docs, I'm mark wait, we're joined by oleg Menasha, kristen, whetstone, roman rodriguez, Gil and I apologize I, don't know how to pronounce your name. Could you announce yourself?

A

A

Well, let's proceed: what we'd like to do here is our goal is with this first meeting is to review where we're at and do our best to prepare to submit our application on time for the 23rd of April deadline for the for the google season of docs proposal. So my proposal is not to review the agenda and ask everyone in the in the meeting to as I review the agenda and know things that you believe should be added to the agenda. We'll add them to the agenda and then we'll actually work through the agenda.

A

We will end this meeting on time in about 40 minutes so that we don't spend an inordinate amount of your time, but I like to work from the agenda as our driving driving plan. So I'll spend some time discussing upcoming events. I've got a brief status report to talk about some some details and things, then the bulk of the meeting I think is on application. Stablish review, where oleg will can lead us through a discussion and I'll capture action items.

A

If we have time I'd like to review project ideas and possibly assign potential mentors to those project, ideas, then in the last few minutes of the meeting I'll summarize the action items and will plan for the next meeting and I would propose that group plan when the next meeting will be and then conclude this meeting are there other topics you would like to have on the agenda.

B

Well, we could do some introductions if time allows, but they, if you don't like everybody on the call today, so maybe we could eat next time. It's better good! That's a good proposal. Let's, let's include that.

A

A

Good, okay, any other is getting ready. I.

B

Think no I would wish we could get to application status reviewer as soon as possible, because we've had a few days left right. I would rather starve in discussion.

A

Are you suggesting we have to put this one at the top of the list.

B

I like well, it would be nice, but they it's totally up to you and we can do it I. Don't we let's, let's.

A

Do that, let's put that? Let's put that right here to top, and that way we're aware that also gives us an introduction to many of the things that that would have been in the status report that gives us a more natural, a natural place to do it. Let's talk about the real application, good mm-hmm, all right so application, the application is due.

A

April, 23rd and I propose that, as a matter of that, we follow the similar pattern, as google Summer of Code has been doing where they tend to post Jenkins that IO blog posts to give broader more global status. Reports yeah I like that, so then Oleg. Why don't you take us through application, establish review and I'll take notes? Don't keep.

C

Sorry mark um what about the Pinkins x and we're doing t proposals are I won four kingpins and ones for Jenkins X I? Do we need maybe put something that that we were going to do the same equivalent for Jenkins X, nice.

A

The intent was to do a single google season of Docs for the entire, where and then Jenkins and Jenkins X would be 2 to power. Two components of it did I get a correct.

B

Or like a lot of Jenkins is a project in context, for Molina is a sub project in.

C

B

Organization now so one kills, PDF transition is finished. Jenkins X is a digit to participate in google season of dog, so google Summer of Code as a part of Jenkins organization. Once the transition is done well, it will be a topic for discussion, but right now it's perfectly fine to have change sex project ideas but yeah. In order to have things like project, somebody has to propose thinking. Sex project hasn't.

C

So that's why I said John is working on Jenkins X documentation in the community and for cloudBees, and so the plan was that he would lead some Jenkins X projects if, with within this google Summer of Code, to try to spark more community interest in writing for Jenkins X. So that was.

B

Talked about about how community work happens and how G so can the G thought happened because right now we cannot really say bill about any other project ideas. So if you want to control you it on example, up for Google sees a Summer of Code because you have everything can process, but you have pretty much the same process for G's research, though how it happens.

B

Each organization was a number of proteins. For example, here's a list of project ideas created for jin-seok, which organizationally is expected. This list of project ideas, then potential technical writers will be reviewing this project. Egg is a relation called the community and at some point applying to the projects and only after applications when the reserve processing of applications. So there is a decision made to be shared. Projects will be acceptable, so it means but yeah we can have one project for Jenkins, one project for Jenkins eggs, but ultimately it's too early to talk about it.

B

We just need to get our projects, we need to get applications and if you get multiplications, then somehow the site of implications we accept as an organization.

C

Okay know that that makes sense, yeah I just like Tracy, and you realize that um it's all under one project and the Jenkins eggs would be like a sub competitive Jenkins I. Just.

C

B

It's a potential topic to discuss because we have six days till the deadline publication. So, for example, if you want to have fun, we could have separate applications for Jenkins and gentillesse X, it's all possible and in such case we can have up to four projects. If both organizations get accepted, I.

C

Don't yeah I, don't know if Tracy's available, but yeah I mean I, just I find either way I'm just trying to make sure I understand. You know what we're proposing, because when I talked to Tracy a couple days ago, it sounded like she. She said that an organization can propose up to two projects and a couple days ago I. She said that we were gonna, do a Jenkins project and Jenkins X project proposal since each or can propose up to two so well.

B

I'm not aware about any of these discussions so yeah there might be some internal discussions, but in the mailing is that there is no discussion about that. So, speaking of the community side yeah, currently we do an application and the notification what we say: it's mental incapacity. So you know occasion we say how many technical writer does your position want to mentor this year, one or two?

B

We have only teachers, so we can say that we want to mentor to projects, but yeah, then we'll be still project ideas, so it will be enough of project ideas. Now we have maybe five and potential technical writers they will go through will be going through the list of project ideas, selecting color ones, which a interesting to them, rich of the community and the pack so yeah.

B

We would be interested to have Jenkins latest project for sure, but it would really depend on applications. I ET apply as a single organization jenkins, it would be, will really depend on the applications if we apply organizations like gentle, music, managing sex organization, let me just mean they have up to four projects. It was get accepted and, secondly, each projects would have independent resource pools in most ways are possible and it's something what can be discussed now, because now we do on the one application for doing this project.

B

But if somebody wants to do a separate application for Jenkins X, it's something we could do.

C

Yeah, okay, so no that's why I think it works either way. I mean I'm, not super hung up on whether we divide into one or two projects. I just want to make sure that you know that there are some Pinkins topics on here, because I think it's a great way to get people to write for it and and John is already going to it's already contributing to it anyway, and you know we could build some momentum around there. I would love to okay.

B

So if you want to have a project for Lincoln sex, we need to have I think the sex project ID M by E. Well, it will be pretty shortly, so it wouldn't be a pro 2039. It can be done a bit later, but it will the first step to have a gentle sex project would be to have a drink sex project idea. Okay,.

C

Yeah, that's what Tracy was saying she so she said that she was gonna. Send me um the proposal and show me where to like put in the ideas is that this document that you're showing right now, yes.

B

C

If you can send me the um you just send me the link to this I'm happy to to add in you know, John and adventures. We will sit down today and add some suggestions. Thank you. Yeah.

B

I put most documents Richard, so.

B

So yeah probably return them back to the application process. Yeah. We discussed some it's right now, but yeah. There are some open questions. It's not only about project Ares project I need. We discussed every stem ringing project ideas in this list and it would be a nice step forward. So if anybody has important in mind oppose the change in this document, everybody should be able to propose a change. So you just go. The document. Click suggest change and write your own project. A key here, for example, let's say something in context: whatever.

C

No yeah we will. We will do that, um we'll find some time to do that. Thank you. Yes,.

B

Oh, it would be the first step and yeah. Maybe it's a question to you and also mark and Tracy, so here the residual just to have more than two projects. Maybe a plan as Jenkins X and Jenkins X independently, would be a good step for it.

C

Sure yeah, but yeah I'll put there are doing an X proposal. In that section you just added, and then you know Petra would love to be a mentor as well. So if there are any potential Jenkins proposed topics that we can add or as a potential mentor, that's fine or we can come up with some additional ones whatever. Whatever you know. How many project ideas do we need to have here?

C

B

We need to have several project ideas, so you know the.

A

B

Least, we're well more less fine, it's always nice to have more project ideas. So, for example, in google Summer of Code this year we have 27 project IDs in G, so we can have less but yeah having more project. I guess is still still helpful because it will give more choice for potential technical writers and if you propose to those project IDs, so different technologies takes different areas. Then there are higher chances that you will get modifications. Okay,.

C

So great we'll sit down today and add some things to this list with Petra and Jonah's potential mentors and yeah you guys can can let us know anything. Mm-Hmm.

D

C

Awesome. Thank you. Thank.

B

You so yeah. This is one part of the application. We really need project ideas, but it's not a dominant part of the application. What else we need to do by April 23rd? So you may see that there is another document called ease of application, so it's. Actually. This is a Google Form, which has been originally created by me on the first B of G certifications. So just have a stake in the ground. You may see the tether it some texture there and yeah. It will appreciate if you guys take a look at the tags.

B

Maybe proposed changes. I perform is not been week. Well, it's much smaller compared to diesel, but a it will include some beads and one of the beads in which we need to discuss is linked to your organization, page about season of dogs. So this is a which is still nice and kind of which I wanted to discuss today because well, for example, it's oppressive language page on Jenkins on your website. So there is a Jenkins.

B

Are your projects JSOC and it's a kind of linking for all information about DSO, including student, documentation, members, the communication project documentation project pages project, ten years at cetera, so everything is like ingenious. I got other product, for example, outreach it. They do not have landing pages from genocide or a mainly they should, but right now they don't what the question here in this application that we actually expected to provide a landing page. So my question would be to participants of this meeting. How do we do that?

B

Well, one the best way you say, but yeah. There are other proposals out intended.

A

Make sure I I prefer I propose the action item. Mark Wade takes the responsibility to create a pull request to Jenkins that IO to create something smaller than but similar to google Summer of Code, because the the model feels like it works well for us I think that's simple direct and gives us a public place to put it ya.

B

Know one of the problems we should be there. Mr. JSOC police lock was grated big years ago before we had special interest groups. So here you may see that JSOC is the actually listed as a sub project in Jenkins. So on the same level like a Jenkins, X remoting configuration s code, which is probably okay, but now it means we have community pages. Maybe it might be, for example, duty and umbrella advocacy and outreach, or might even have a just documentation sub project and have jay sauter as a suffrage building delimitation sub-project.

B

So what's something what needs to be discussed, but also with the best Lee and.

A

Here's a pull request and an acceptable way to test drive that do we need it, given that we're only six days away from application, I'm produce pull request, rather than the full Jenkins enhancement project process. The jet process no process isn't something we.

B

Need to do therefore Sean yeah. For me, the most straightforward way was paid between.

B

Or maybe documentation special interest group yeah I'm, not sure whether it's the right approach, because yeah I would run expect each sub project and each special show we just took to be responsible for its own documentation.

E

Right and to me, it almost feels like this would, since they're so similar it kind of overlaps a little bit with the google Summer of Code group yeah right yeah. So it's like it would make it be a little bit harder to have a whole nother group for a program very similar to google Summer of Code.

B

Yeah so yeah, there are multiple ways. One way is to just have an entry here. Well, it's almost three to four three Oh.

A

So I'm I'm great with doing that I was assuming it would go under special interest group that you're recommending actually be treated as a sub project. It's big enough with enough things. It feels justifiable as a sub project. I'll do that.

B

hmm So you may hear you wrote documentation and seek.

B

Correct, whatever works for you.

B

Okay, so here this is the second big open question we have for the plication the rest of the.

B

Neutral wire, so primary adminstrator.

B

We have been applying filters, this training and fool me.

B

B

One thing which wasn't clear to me is about this open source project with fiction.

B

Channel because yeah, for me, it's not clear what is the size of the description that we should provide on you applied to j sod. You get the information about content side. Is you need to provide here? It's just a free form, so you can provide war and peace there or you can just provide sentences like okay. Well, actually, only one sentence, so maybe it's something we need to discuss to understand what we really need to probably there so.

A

This this description is read by candidates who are considering whether or not they would like to submit an application to us to be part of google season of docs as technical writers right well, I would assume.

B

So but since it's a first year of Google season of dogs, so we really have no idea what will be the website? What will be the project Eastham, so it seems that they decided not to poke the event I jsoc structure in JSON, so yeah I'm, not sure how will the final Virgie sort website look like? Oh yeah, that's why, for me it's not clear what it should provide here.

A

So I I'm proud to leave it exactly as you created it. I like that description, I think that's a unless there's strong opinion. Otherwise that feels good enough to me. Rok's.

B

So right you shave it. Okay, yeah, so I just wanted to show examples and then just do that. I'm actually logged in so I'll, probably cut someone bits of the video later King, oh yeah.

B

Maybe we can just askance luck later or typically, this I believe it. If something goes wrong me and always ask jay sauter supported to update the website it to make more information, but more info.

C

I feel like we should still be a little bit more descriptive right. It's supposed to be a compelling reason to accept us I'm assuming to describe our project, so I think that's a great start, but I'm happy for some of my team to help maybe add a few more sentences to it. To really just you know, Jenkins.

B

Itself, yeah I can show you how it looks for JSOC now because Jessica's already running so.

C

B

You can go to organizations, so there is a number of organization, something like 200 organizations. This time we can just look for Jinyoung being engineer. You have been.

B

C

A character limit, it seems like these are pretty short I wonder if we're trying to fit into a certain limitation, yep.

B

Jujitsu there is definitely a limit, so it's okay, you provide the bathing markdown for mantra. This text size lenient, so you can estimate the water would be the target content. So now he is at the description we have on the edge its oxide, but I'm not sure we can do the same for google season of dogs because we just need Google form. So what not? Markdown no molluscum- and we also don't know the target size of french fries.

C

Right, yeah yeah happy to help. If you want get that information, someone that my team can help you with that, if you want it once you get the character limit, mm-hm.

B

Yeah Rick, oh yeah, whatever proposals think it'll be helpful. Yeah.

B

B

Though what happens next for us, so we will be just editing this vacation, so we, if anybody wants proposed changes, just do bed and natural 22nd ie plant, just okey all the fields and the movable, because a I started the Google for and they cannot transfer transfer rate mark. So I will be submitting the final proposal yeah and they really prefer to do it on Sunday, not on the Monday.

C

Okay, so you want us to get our stuff in by the end of this work week right, so we have I in today, Friday we're good yeah.

B

It would be my preference so on, but be on Sunday. We because you're on Monday I cannot guarantee my opinion.

C

That's fine, we'll put our stuff in their brain a day, Friday.

B

Yes, okay, then, here we can just agree that you know on Sunday our target that on Sunday April 22nd, we have everything of 21st acquainted with. We have everything in place, I said eat it, and if there are some last-minute changes we still and apply them, but the we target having final occasion on Sunday.

B

Okay, so that's it from me: if there is no questions, we can just press it to other agenda items. Okay,.

A

Where they're, all like one of the things that was noted in by Slayton in the in the dealer channel, was the more detail needed on Mentors? Is there something in the application that we need with regard to Mentors No.

B

So what we need Mentors, the mentors they expected who very to who passed the consent form or whatever form, stop all mentors, and that means they help us through whatever Google. For me, if you're on the g-shot website, you can find the guidelines and all mentors expected us.

B

This fall, but I believe that there is no strict deadlines or ferment or means have to pass them on by the application deadline. So both you and Tracy should complete it by Monday great.

A

And I've already completed the alternative organization administrator yeah how to complete the organization administrator because I think they have it attached to who submits the form. All right and.

B

That's why we have lunch in it because it's the first year of Google season of dogs, so we have enough process, isn't established yet, okay and if something doesn't work, could we have a mane increased and we have a slack channel and believe that it would be the best way to clarify any kind.

A

Of question well, and so their request was their request on the slack channel is Mark. Could you submit the the the application instead of having Oleg submitted? They were I think trying to take the easy way out in terms of of not having to go through some special push. Ups. To make me organization, admin.

B

A

Not alone, okay. So let's proceed, then, with the assumption. Now that you'll submit the application on the 22nd and if we've learned something in this left channel that says no that won't work we'll do it differently, then we'll find a way to meet their their request. Rearranged.

A

Okay, so any other things with regard to application status, review Oh like mmm nothing for me, okay. So let's take up the status report just briefly, then we would like to switch to you zoom for future meetings. One is that, within the context of the continuous delivery foundation, there's active effort to do that, the other is it will help. Many of our colleagues in China get easier access. So that's the plan we'll follow the same pattern in the future of sharing a link to the location in the giver channel.

A

Please consider Gitter as our primary communications channel and we will use blog post to jenkins I/o for future broad communications and so under.

B

A

Vendors antigens aryan dogs right correct. Yes, thanks I should have embedded that link absolutely yeah.

B

And I think that it also makes sense to reference that I made at least because yeah what we do in all of Summer of Code. We at least say that we try to do as much communications as possible in the Middle East, because memory is a synchronous, communication channel and unfortunately it isn't a good channel 14 for mass communications. It doesn't support trails, etc.

B

So we are out or sure that we do try to do. Mine increased for all kinds of long conversations and get a full shot. Sync up so.

A

That is it. Is it better to declare that will use lasting conversations in in the mailing list and interactive communications in the indicator channel hello, my addiction I, like that? Let's, let's take that as a yes, unless we get wrong objection from someone.

C

Can someone share this stuff with me? I can't seem to find it. Oh.

A

It's it's in the you'll find a link to it in the channel in the get ur channel and we'll also, happily we'll paste the link to it every so often in the get ur channel. Just so people are aware also put it into the mailing list.

A

Page so I wanted to take a few minutes here to be sure that we've we've got a current list of who's doing what in the act in the effort so I'm taking on organization administrator responsibility, Tammy, specifically I'm, choosing to do only one one product, one organization here, not two that will limit us to two projects or goal would be have one of those B Jenkins and the other one Jenkins X, but I'm not ready to sign up to be organization administrator for two two different projects, yet I'm worried that that will be more than I can do.

C

A

Yeah I mean I'd, be happy.

C

To to help, if we want to take this offline mark- and you know, I can discuss happy to figure out how you know my team can help with that since I know that you get time limits here, great.

A

Thanks Tracey Miranda has agreed to be the alternative organization administrator she's not available to attend right now, but she's very much committed to then mentors I listed, the mentors of which I'm aware so Petra Kristin Jo are Nam and John ha others. If I made a mistake here, you're welcome to delete yourself by a proposal or to put yourself in. If, if you would like to be a mentor, you do need to register with Google.

A

Each of those registered words is a hyperlink to a form you just need to submit that form.

A

Any questions on roles, responsibilities and people, the one, the one get here's to our providers. We don't have that I'll submit after we create the proposal. Go ahead right so.

C

I'm trying to understand the break-up, you said that we're so are we submitting one or two? You say: you're gonna be org admin for the Jenkins thing, but you're not prepared to be it for more than one so we're submitting one or two applications. I'm still awesome, I picture.

A

Was one application which will have up to two will have many project ideas and the way Google's described it is they'll, accept up to two I think once I bet on this, what I've understood I like and those two technical writers will submit their their applications to it and if the applications are accepted, then we mentor them as they do the work on those two projects so.

C

In that other document, we have all these project ideas. We propose those and then up to two writers will pick from the whole list. Is that what happens mark.

A

That's I'm not sure that it's up to two writers is that applicants, so technical writers, yeah, so technical writers propose apply to the project and if we accept them they they then work on that project ID and we assign mentors OSIS for that project idea. Olena did is private correctly.

B

C

So the project ideas that we list in the application that they're they're not gonna, all be done right and like we don't have control over which ones get picked correct. So they just pick from that list and then, if and then so I'm trying to understand like so we have these product ideas and I see on some of my potential mentor.

C

I see you know you mark for some of them and then we'll obviously propose some things in the application, but then really the mentors that are going to work on this or depending on what the writers that decide to work on this project select.

D

Maybe yeah, maybe oh.

B

Yeah we clarified it. We can really influence each share projects and get selected by potential technical writers, but they need submit applications to organization and then we have with make power the projects you want, but yeah there is no magic. So, for example, if you have Jenkins X and if nobody sir needs an application to Jenkins X, you won't be able to pick this project. But if somebody ourselves, then you will have another one and we will be making it as an organization.

B

What happens we cannot say for sure which number of occasions we will get, what quality of these applications? We will have sorry, it's say yet to be seen but yeah. If we are lucky, we can have projects and we will have a final say which project applications we take. Okay,.

C

No I understood just trying to understand how it how it works, appreciate the explanation yeah.

B

Right so there is a long document about google seasonal talks where they tried to explain all these selection process, but he mostly thinking from jae-seok with some variations.

C

Okay yeah mark, if he, if you need an admin or whatever org admin, turned up for stuff art and please let me know I'm happy to help with that. Thank.

A

You thanks very much.

C

No thanks for letting us be part of this I'm excited I think this is right.

B

So if we decided to go with two project, I am able to be alternate for are some alternative organizational mean in the Jenkins project.

D

B

Finding is not being ordered mean because JSOC is pretty much enough for me, but a place he wants to focus on drink. Sex I can probably fill this slot. It mean it.

A

Great thank you thanks, like yeah, so I'm yeah great in terms of in terms of other details. Here, we've got. We need additional project ideas so and that I assume we're going to assemble project ideas. I gather more project ideas this week, so before end of this week into that document into the DA and then April 22 we submit and it then comes better. The technical writers can then review those proposals and submit their applications.

A

So I think I've captured the action items in the Google Doc. Already there were two that we listed there Oleg to submit the final application, Sunday the 22nd and me to submit a pull request to Jenkins Idaho dot IO for google Summer of doc. I think we should put one more, which is add, Jenkins, X, project ideas, and let's put that on John. If that's, okay, yeah, that's fine, all right and John. Let's see if I've got your email address here, I don't touch JH a at cloud. Peace is that correct, John.

A

A

Okay got it so that one's assigned in the dark I would like to have our next meeting. Well now, the question is: is April 22, that's a Sunday, isn't it and that's not a terribly workable day for a next meeting, so it should. We rather consider another meeting one week from now to talk about where we are.

B

A little bit feminine on April 24th, but yet not really required at this making a believer.

A

Yeah and oh, like can you my apologies? I, don't know the details on the timelines after the April 23 application deadline, when will Google make their decisions on on project ideas or what is the next major milestone after that? So yeah.

B

That's why we have links only in these documents. Just a second I'll find it useful links. G-Suit, yes, boulders. The timeline here: okay, yeah I'm line, though Apple 23rd here, is line. Publications then April 29th is the review time. So on April 30th publishes the list of organizations and then yeah. Then they will be one months of discussions, though obligations. You may see that everything career starts in June great.

A

So it feels like to me a good status would be the week of April 23. We get together to double check that we've satisfied all the things that Google needs before they publish the list of mentoring organizations, so I will send out a doodle doodle request to sound for something the week of April 23 and start an agenda for that I mean great any other topics that we need to discuss here today.

B

I, don't think so.

A

All right thanks, everybody, let's go ahead and conclude this meeting thanks very much, we'll start the agenda for the next meeting and the Google that the doodle to request to find a good time for everyone thanks very much for being part of it. Thanks.

D