GitHub#
Overview#
GitHub is a web-based platform that provides tools for version control and collaboration. It’s widely used by developers to store and share code, track changes, and collaborate on projects with others. Here’s a general overview of how to use GitHub:
Create a GitHub account: To start using GitHub, you need to create an account. Go to github.com and sign up for a free account.
Create a repository: A repository is a place where you can store your code. To create a new repository, click the “+” sign in the upper right corner of the page, and select “New repository.” Give your repository a name, add a description if you want, and select whether it will be public or private.
Clone the repository: To start working on your code locally or remotely, you need to clone the repository. To do this, click on the green “Code” button and copy the URL. Then open up your terminal (or command prompt on Windows) and navigate to the directory where you want to store your code. Type “git clone [repository URL]” to clone the repository.
Make changes to the code: Once you have cloned the repository, you can start making changes to the code. You can use any text editor or IDE to edit the files.
Add and commit changes: Once you’ve made changes to the code, you need to add them to the repository and commit them. In your terminal, navigate to the repository and type “git add .” (the period indicates that you want to add all changes). Then type “git commit -m ‘commit message’” to commit the changes with a message describing what you did.
Push changes to GitHub: Once you have committed your changes, you need to push them to GitHub so that others can see them. Type “git push origin master” to push the changes to the master branch of the repository.
Collaborate with others: GitHub is great for collaborating with others on projects. You can invite others to contribute to your repository by adding them as collaborators. You can also fork other people’s repositories to create your own version of their code.
Resources#
Here are a list of resources to get more advanced features and workflows that you can use, such as branching and merging, pull requests, and issues.
CarpentryCon 2022: Skill-up - Using GitHub for Collaboration in Open Source Communities: In this recording The Turing Way Community introduces participants to using GitHub as a tool to support collaborative documentation-writing and knowledge sharing