Repository to aid a live demo of how to use Git and GitHub Desktop for the SunrIde Training Programme.
This activity involves adding you creating a text file with your name as the file name and adding a fun message inside it.
You can do this by cloning the repository, committing your changes, pushing and pulling any changes!
Please refer to this git cheat sheet for help with commands.
Each step is explained below:
GitHub desktop is a GUI tool which can be used to manage Git repos easily.
It can be downloaded and installed from https://desktop.github.com/.
In order to edit the files, I recommend using Visual Studio Code, it's one of the most popular text editors available and can simplify your developer workflow a huge amount.
Cloning a repo is creating a local version of the repository, this includes all of the commits and branches associated with the repo.
In GitHub Desktop, click "Clone a repository from the Internet" and then select the "URL" tab. Once shown a prompt for the repository URL, you can enter https://github.com/TeamSunride/Github-training. The local path option tells GitHub Desktop where to create the local repo.
The next step is to use VSCode to create a new file with a fun message inside.
You can open the repository in VSCode by clicking the "Open in Visual Studio Code" button.
Once VSCode is open, you can create a new file by clicking the "New File" button on the sidebar.
Enter your name as the file name (making sure to replace any spaces with underscores) and appending ".txt" to the file name, this will create a text file. You can then add a message inside the file.
Your file should now be highlighted in green in the side bar in VSCode, this indicates that the file is new and has not been pushed to the main repository yet (it only resides in your local repo until you push your change).
The next step is to create push your change to the main repository.
Start by opening up GitHub Desktop again, once opened you should see your file name and file contents in green in the center of the window. Here you can see more information about your local repository, such as which branch you are currently working in, as well as when last time GitHub Desktop fetched from the main repository (checking for updates but not pulling them).
On the bottom left you can enter a message for the changes you made, as well as a description if desired. Once done, you can click "Commit to main".
This will package all of your changes into a commit which is now ready to be pushed to the main repository. This can be done simply by clicking "Push origin"
You have now created and pushed your commit to the main repository, congratulations!
Once changes have been made to the main repository, you can pull them to update your local repository. To do this in GitHub Desktop simply click the "Pull origin" button.
If you now reopen VSCode, you should be able to see the changes reflected onto your local repository. If someone else has created a file and pushed it, it will now appear in your local repository for you to work and collaborate on.
Refer to these docs about GitHub Flow, which is very similar to what we just did, but with branches within a single repository.
Try uploading one of your projects to GitHub using the things you learnt today!