 Welcome back everyone. Today I'm going to show you how to edit a text file using only GitHub. The reason you might want to do this is because there's a lot of resources posted as text files on GitHub. So for example, we have the digital forensics discord server, the law enforcement resources section provides links that could be interesting for law enforcement or any digital forensics practitioner. It's just a simple read me text file written in markdown language. I am editing now the digital forensics discord server law enforcement resources. I will put a link below for the discord server if you want to join and discuss things about digital forensics. These law enforcement resources basically it's just a link right now they only have one resource listed but then they also have kind of a short tutorial about contributing to the project being able to edit these text files is a good way to contribute back to open source projects very quickly and easily rather than writing complicated code. So the first thing you have to do if you want to edit these files is create an account and log in. I've already logged in I've already created an account and I have a group Defer Science group in GitHub that I'm going to copy the repository to. So if I want to make any changes I have to make my own copy first, change my copy and then submit my changes to the original owner. Anytime you want to edit anything on GitHub you're going to create your own local copy and then modify that copy and then submit it for review. So I'm going to go to the law enforcement resources section and to create my own copy of this that I can edit I need to click on the fork button. Okay so right now two people have forked it so I'm going to click fork and then it says where would you like to fork this resource. J.I. James is my account but I want to put it into my group so if you have a group or you have multiple accounts they'll be shown here you'll probably just have one account and then just select that account. I'm going to copy this to my Defer Science group and then it's forking the the resources page and it'll only take a second. Okay so then now if I go back before we only had one repository if I refresh you can see that I have law enforcement resources now. If I click on law enforcement resources I have all of the same files as the original repository. Okay except the difference is this is owned by Defer Science. If we go back Digital Forensics Discord server still owns their own copy but now I have my own copy that I can do anything with that I want. Okay so the next thing we're going to do is go to the readme file that's usually the file that we're editing you can see that there is a pencil icon once you've created your own copy you should have a pencil icon for the readme go ahead and click that and then we have a code view of the data or in this case a text file so what I'm going to do this is written in markdown there's lots of resources online about how to code in markdown it's very straightforward I won't go into that too much but we will just start editing this just like a normal file we have our law enforcement resources and if we have one hash that's a top level heading two hashes is a second level heading three hashes is a third level heading all right and then we have contributing to the project as a second level heading so I am going to change this view a little bit let's look at what it actually looks like top level second level third level well this is going to be a little bit confusing once we start getting a lot of different resources in here so I'm also going to change their formatting a little bit as well as add some links all right so the first thing I'm going to do is under max mind I'm going to add my own link so I just start typing like normal I just put in two return keys and I'm going to add the Sherlock database and this is basically a database for mutual legal assistance it has legislation from a lot of different countries and a lot of good contact points and information for cybercrime investigators so this is a good resource for law enforcement so I'm going to go ahead and copy that url of the resource I want to add and then I need to create a new heading because it's not IP resolution services it is international corporation or mutual legal assistance so I'm going to do a second level header and I'm going to say mutual legal assistance resources and then so now I've created our heading the next thing I need to do is just type what I want but we would have a list of a lot of different things so I'm not just going to make a paragraph let's go ahead and create a bullet point so I just use the star sign with a space next to it and then I've created a bulleted list so I can just basically keep going down and making more bulleted items so now I just have one so I'm going to say UNODC Sherlock okay and then this is legislation competent national authority list and treaties okay so that's basically it so I have UNODC Sherlock legislation CNA list and treaties well this is just text right now so it's not totally useful because the person still has to go look up what UNODC Sherlock is so I'm going to add a link remember in a link there's two parts to it the part that the user sees and the part that you are actually going to the URL so the part that the user sees I want it to be UNODC Sherlock so I'm going to use a square bracket on the beginning and then a square bracket at the end of that okay and then that creates a link view and then we type in a curved bracket and then a URL and then finish with a curved bracket so we have a straight bracket straight bracket curve bracket curve bracket with text and URL inside okay so now we've created a link in there so let's go ahead and preview that we should have a new heading called MLA resources we should have a bullet point with a link and a little bit of a description here so click on preview and then that's exactly what we have here so MLA resources UNODC Sherlock and I can click on it and then we have a little bit of a description and that looks a lot cleaner than actually a couple of these things up here so let's go back and change the rest of that formatting so instead of MaxMind being its own little section I'm going to go ahead and remove that remember I'm not removing this on the original user's document yet I can submit these changes to the user that created this but this is only changed on my copy okay so I'm going to create a bullet point we have MaxMind and then I'm going to do the dash again just to keep it consistent and then I need a link for MaxMind and I've already looked it up because they didn't add the link so then we have square bracket, square bracket, curly bracket, URL, curved bracket okay now I can just take a quick look at the preview again and we have MaxMind with our description and that looks a lot better the next thing I want to do is we should always have one space between the heading and the text that's just the way the standard usually goes and then for contributing to this project that's actually not a tool so I'm going to go ahead and make this a first level heading just to see if it looks better yeah it kind of separates it a little bit more okay so that's pretty much all there is to it just some basic editing I've added some links in here and now whenever people go to this to my page they can see those changes once I save them so commit changes give it a title we have to scroll down to the bottom we want to commit and commit is just saving so what did I do I added Sherlock link plus formatting okay added Sherlock plus some formatting the reason you want to do this is because for yourself like you can keep track of actually what you did and for whoever you're going to share this with they can see the changes that you've made and understand really quickly in one sentence basically what you're doing so try to make this commit statement as descriptive as possible without being too long since we're just doing a text file I'm going to commit directly to the main branch that just is where I'm saving it at so then click commit changes and that just means save it back to your local path so now we can see the changes I have my two links here and that's that's pretty much it so now my copy has been updated we can see that it was updated 15 seconds ago and then the important thing here is this branch has one commit ahead of digital forensics discord server main where I copied this from it says that I have changes that they don't have so then we have two options here contribute and then fetch upstream so if their copy on the digital forensics discord server was also updated at the same time and they have changes I don't have then I can do fetch upstream and I will download all of their updates okay but what we want to do now is contribute this back to the community right so I can click contribute this branch is one commit ahead of digital forensics discord server main so what we'll do is create something called a pull request and what this does is basically flags them and says hey I have changes you guys can include these changes if you want to so we're creating a pull request we had didn't change a lot so it does say able to merge and then in the bottom you can see that I have my title and you can see that I have all of these different changes that I've made everything in green is what I've added everything is red is what I've removed and then that's pretty much it I can review this so then if everything looks okay click create pull request again I have my description there so the more descriptive your description whenever you send this over to the person who created the file originally they can just read that description and say oh yeah they've added a link okay good so make sure your description is as descriptive as possible here that way they can make a quick decision and then just hit create pull request and then now we're back over in the digital forensics discord server law enforcement resources so this is not my local copy we have pull requests on their side that's one that means that they have one update that needs reviewed right they're not going to let you just push your changes directly to their repository they need to check it first so this pull request goes into a queue and then the author basically gets to decide when those pull requests get implemented in their code my account wants to merge from my repository okay no conflicts that's good and then you can even leave a comment so sometimes they might ask for more clarification if it's a complicated update but most the time if it's something simple like adding a link most likely they'll just accept it or or reject it directly without too much discussion so we are back in the law enforcement resources we have our pull request if I look at their copy notice they don't have those links yet they have not updated their copy but if I go over to my account if I go to my account law enforcement resources I do have those updates right so if they accept my changes then their copy will also be updated if they reject my changes then my copy is still changed and their copy is not so it's that's why it's called a fork because they could go in different directions so that's pretty much it for editing a text file in github and then submitting it back to the original community this is a really really good way to interact with the community because it's very straightforward you can do this with documentation you can do this with adding links editing documentation is a really good way to give back to the community because so many people are using documentation so we have to make sure that they are up to date but sometimes they kind of get neglected so if you want to start working with the community somewhere just doing this kind of thing is a really good way to begin okay so I hope that was useful for editing text files on github and hopefully contributing back to the community thank you very much