 update project. It is the 28th of April, 2022. Thanks for being here. So today we're going to take an outdated screenshot. Let's see. Oh, and my screen is not shared right now, is it? No, no. Share my screen. So sharing my entire screen. And now here is the spreadsheet of outdated screenshots. So now how did I get to this sheet? I used our our contributon folder on Google Drive and inside the projects folder there under screenshot update, there's this sheet outdated screenshots. And so each member of the team has a link to this folder and they can find this outdated screenshots page. So then let's make this thing big enough to actually read. So what it is is we had done several checks to see are there which things need a screenshot update. And we looked at one of them that we looked at was blue ocean getting started. So this link right here says it needs the plug-in manager screenshot updated. So I'm going to open that page. Okay, so here it is. This is getting started with blue ocean and this page, the available tab does not reflect what how how the product currently looks. So let's go look to see how the product currently looks by looking at a Jenkins installation that's running. Oops. Okay, let's get a Jenkins installation that's running weekly instead of me using fat fingers. There, okay. And here I need to fill in the correct password. Okay, so this is a Jenkins version that's one week out of date, but only one week out of date. So I'll get it updated. It's close enough for this purposes to make this these screenshots useful. So if we look, let's just compare the between the two. I'm going to page back and forth between them. So here's it was on the available tab. Notice how different the available tab is here compared to here. So there is definitely a difference in in those two pictures. This one, the old tab had install name version. The new one has install name released, and has a lot more information on each row about the plugins that are available. So this is a really good one for us to update the screenshot. Now the challenge is it helps me if I know roughly how big that picture is. So I'm going to save this just to remind myself. Okay, I've saved it. Now if I go here and how big is it just to just to see. Okay, so properties. So this thing is 1820 by 1250. So it's quite a large screenshot. So I can I can certainly make it smaller than that and not do it any harm. Good. I see that I'm safe there. So this screenshot and what it's showing me a picture of is available tab. So I'm going to actually narrow my window to something much smaller so that the message will get across. How about there? What do you think? Is that a reasonable width for a screenshot because then I'll trim it down? Yes, it is. Okay, so now I'm going to take a picture and I like this go full page thing. It's a it's been very helpful for me in terms of taking pictures. You could use whatever screenshot tool works for you on yours. I then do an edit. And now I can crop this image. So that it's showing plugin manager. And now I have to scroll way down here to get because I don't need to show all that much. So let's look. Now let's see what the other one looked like. So it had what do you think is that okay, it has the buttons on it. Oh, no, wait a sec. I'm taking the wrong page. No, this is available. Okay. So it showed the buttons on it. I'm not showing the buttons. Do you think I should I should probably include the button somehow? Shouldn't I? Yeah, you should. Yeah, which means I've got to do something different then because because this list is just too long. This picture is too long to use that way. So what I probably want to do is I'm going to save save this two different ways. I'm going to save here. Call this done cropping. Now I'm going to download it. See download and export. And then I'm actually going to open it locally. With a program that does image editing like paint. And now I've got it here in Microsoft Paint or whatever image editor you use on your on yours and I'm going to go make changes to bring this thing into what I want. So I'm going to cut this stuff. Oops. Right again. Let's cut from there. Okay, I just did a cut and I'm going to go up here. I'm going to do a paste and if I scroll it down a little bit. I can align it somewhere like there. Yes. Okay, so now admittedly this is. I had to do that little bit of edit and now I'm going to do a crop. To throw away all the extra stuff that I don't need. Oops. How do I get there? I need to shift the screen just a little. Let's go. You can tell I don't do image editing as often as I should do. Okay, so cropping this image like this. Nope, I still don't quite have. Okay, so I'm going to have to zoom. Aren't I view? Oh, oh, here we go. If I just know that wasn't what I wanted. Okay, so how am I going to? How? Oh, I bet there's a way to do it like this. Sorry, so I'm not that you're having to watch me do screen editing. Isn't that just terrible? Shame on me. No, it's not. It's okay. Oh, I know what to do. I see. If I grab this. Nope, that was not the answer. Okay, how am I going to? Did you try something out? I did, but I don't know how to do the zoom here. Okay. So there's a hundred percent. What's what's the zoom function in this editor? Yeah, I think you could reduce maybe take it to 80% something like that. Yeah, the challenges, I don't know. I don't see a control here that will let me do that. So maybe I need to just try a different program. Let's I think the hundred percent. I think it slides. It has a slider. Oh, you think it does. Okay. Well, so let's do that. I certainly. Oh, not with photos. Oh, actually. Well, let's we want to open this with paint. Okay. And you were saying that you think there's a slider here. Yeah, right at the bottom of the screen. Oh, oh, very good. Thank you. Like this. Yeah, it's nice to have people who actually know things. Thank you. Thank you. So now we're going to fix my mistake by jumping down here to the bottom. Cutting this much. What just happened? I must have killed my web browser in my paint program. Reopen. Try it again. Okay. Sorry for making you watch me practice. Okay. So what we've got to do here really truly mark. Okay. What we've got to do here is scroll down to the bottom. We're going to copy this chunk. Okay. It's copied. Now I'm going to jump up to the top. And I'm going to paste it. And then I'm going to move it into position. So that it looks. Reasonably correct. Like that. Okay. Yeah. So now I need to. And what you were saying is that if I will just be able to be a little smarter, I can do it like that. And now it's all on screen and I can do the crop. Like this. See, none of this has anything to do with committing the change, but it's, it's actually quite important. Now. How do I tell it to cut? Nope. That's not it. I want. Clearly I need a tutorial on how to edit images with paint. Okay. So. Where? Oh, there is a. Crop. Look at this. All right. Image editing complete. So now I do a file save. And now it helps if I know the name of the file. So going back here to that. No, not that one to this one. The original file name. The original file name. Is what it's blue ocean plugins filtered. So the reason I can tell that is that's the URL that was used. So that's the file name. I want to give it just for my convenience. So back here. Blue ocean plugins filter dot PNG. No. Oh, right. That's the old file. We don't need that. So that would have been another way for me to get it. Now this should be the new file. And it is. Okay. So we have successfully after much pain and sorrow. Found a way to get that file. So I need to copy this. Now I'm running on a windows computer. So I need to get it to my Linux computer. You would do the easy thing and drag it around. I can't do it quite that easily because I have to. Copy it from windows to my Linux computer. And here it's that. All right. So. Now let's go where. Now we're going to get to do the fun part. So this is where we're going to create this poll request. So here's my clone copy of. Oh, let's see. Would it help you if I did the. Started from a fresh copy of the repository. Neither of you probably have copied this repository yet. Have you? No, I haven't. Okay. So let's start fresh. All right. So. We need to get a copy of the Jenkins documentation repository. And so one easy way to get that. Is to click the improve this page link. And that takes us to the repository. So now if I copy from here, the, the URL. There it is. Now I can go over here and I can clone it. So I'm going to say get clone. That thing. Now I'm going to add something that will make my download much, much faster. So we don't have to wait. You won't be able to add this extra little. This. Benefit thing because. You probably don't already have that. That repository locally. So I'm going to do that. Whoops. Get clone minus, minus reference. Oh, it's already there. Okay. We have to throw the copy away that I already have. Now. You'll do a clone. So you do a get clone. Of that thing. And then in that directory. I now have the repository. I'm going to do that. I'm going to do that. I'm going to do that. I'm going to do that. I'm going to do that. I'm going to do that. I'm going to do that. But I'm going to do that. Now I have the repository. And now in my case, it makes it much easier for me to work with it. Have I used the GH command and say GH repo fork. And GH is a, is the GitHub command line interface that I mentioned Saturday. So this says, Hey, it already exists. Would you like to at it? I say yes. and it knows about this one so now I need to check out a branch. I'm going to check out a branch and this is update blue ocean screenshot and how about we call it plug-in manager so no shame using nice long names for branches it helps us remember what's what's what and it should be based on upstream it is good all right so now I've got a branch so if I do get status we'll see I've got a branch the branch is named update blue ocean manager screenshot and in my home directory I put this file blue ocean plug-ins filtered if I go looking for that file with forget LS files command it says that's where it is so I'm going to say move that file that I created into that location now when I do I get status it says hey there's something that's changed yeah that's a good thing now I've got a little script that I run that will attempt to optimize that image and I think we included that in our last set that's in the the Google Doc so I ran that script and it says sorry what was that I said it's there very good okay so so I ran that and it says hey it saved 18,000 bytes out of out of 60,000 something so that was a nice savings so now if we say get commit minus a minus v and it's a update blue ocean again manager screenshot updated live in the screenshot updates project so now gh pr create so this is I'm going to use the gh command line to create a pull request or would you prefer that I do it through the github UI first just in case you don't want to use gh okay okay okay so then let's take that step so what I have right now if we look at what I've got you'll see I have one commit after master on the update blue ocean but I don't have anything that says this has been pushed remotely so if I say get push it will tell me what do you mean I don't know what to do then it tells me what to do I choose this get push set upstream that so what this does is pushes my change to the remote github and it gives me back this nice hint of what I should do next and in the what I should do next it says create a pull request by visiting this URL so if I double click that and paste that into my web browser it puts me right into the update blue ocean plug-in screenshot and you can even see the difference between the two notice the deleted page and the added page so it shows us and I like this because it shows us that the new image is significantly smaller than the old image which is is a big win because it's more readable for human beings on when they're reading documentation yeah so intentionally used a lower resolution a smaller screenshot easier to read in online docs so I'm gonna press the create pull request button now what this will do is it's going to start the continuous integration evaluation process through a series of checks and the checks will will include creating a new site that I can use to see how this looks after my change was made so you remember that today it looks like where is the page it looks like I've misplaced the page let's go here nope not there we'll go here nope we'll have to go back to the book Jenkins documentation blue ocean which was in is it no it's not installing oh blue ocean there it is okay and the page we were looking at was oh this is really sad that I don't remember which page we were even on getting started yes here it was it was the first screenshot in getting started oh now look at this okay I made a terrible mistake it's amazing the number of mistakes I can make in doing this exercise notice what this screenshot was trying to illustrate it was trying to show how to find and install blue ocean with the plug-in manager and I didn't do that oh yeah okay sorry so so the pull the pull request that I just submitted is nonsense right so so let me put a note on this that this pull request is nonsense because it's not showing what we wanted it to show sorry about that needs to show the screenshot with blue ocean filtered in the filter field do not merge this pull request yet sorry that's really embarrassing but thank you for your patience while I make mistakes in front of you I'm going to convert this to draft as a way to assure that no one else can can merge it so you can do you could do the same as well if you realize you made a mistake you just convert it to draft and it tells the rest of us don't merge this okay all right so now we need to go fix the mistake I made and the mistake I made is going to be a little difficult to fix because blue ocean is already installed on this computer oh no no that's okay it's all right it's showing it to me oh good I got lucky I'm very happy about this because it looks like blue ocean is not already installed on this computer and yet I thought I had it installed oh no no it is partially installed okay so I've got to do something different in order to get Jenkins to a condition where I can run without having blue ocean on it so just a minute while I start a new Jenkins and we're going to we're going to do a little more in this demo we've got about five more minutes before I have to end for the next meeting are you okay if I keep doing this okay no problem I already understand it okay you well so I guess the flip side is should I just stop in case there are other questions because I think you understand what what I need to do what I need to do to fix this problem is I need to start with a Jenkins that doesn't have blue ocean installed and I type blue ocean here and it shows the things that can be installed so I do have one question so if I was to do it would I need to uninstall blue oceans from my computer yeah for this particular screenshot yes you would right because I would have to uninstall it and then when I'm done reinstalled right exactly that's one of the complications of this particular screenshot update is that in order for me to do an adequate job of this one although maybe no see yeah see see Mike my system is a little bit weird in that I didn't install the top of a blue ocean thing but I installed a bunch of components that are part of blue ocean because I need the components your system will be even different because you installed the top level and so you would have to uninstall and I would have to uninstall blue ocean in order to make this screenshot be accurate okay okay so I was thinking let me let me try it myself okay screenshot and then get back to you excellent that's great if you're willing to do that that would be that would be super I will I'd say let's are there other questions or would you be okay if we called a pause for today so I can get ready for my next meeting of course of course I'm okay with that thank you for your time oh thank you and it should be I should be able to make the recording of this available I hope within the next 24 hours okay that would be nice thank you thank you okay