Using Github for Chia Contributions
Using GitHub
We use Github for source code control, the two main ways to interact with Github are via the web browser or via cli commands, the below links are focused on the web browser access.
Create a Github Account
The below information has been copied from the Github docs.
To get started with GitHub, you'll need to create a free personal account on GitHub.com and verify your email address.
Every person who uses GitHub.com signs in to a personal account. Your personal account is your identity on GitHub.com and has a username and profile. For example, see @octocat's profile.
Later, you can explore the different types of accounts that GitHub offers, and decide if you need a billing plan. For more information, see "Types of GitHub accounts" and "GitHub’s plans".
Signing up for a Personal Account
- Navigate to https://github.com/.
- Click Sign up.
- Follow the prompts to create your personal account.
During sign up, you'll be asked to verify your email address. Without a verified email address, you won't be able to complete some basic GitHub tasks, such as creating a repository.
If you're having problems verifying your email address, there are some troubleshooting steps you can take. For more information, see "Verifying your email address".
Installing Github Desktop
The below information has been adapted from the Github docs.
You can install GitHub Desktop on Windows 10 64-bit or later.
You must have a 64-bit operating system to run GitHub Desktop.
- Visit the download page for GitHub Desktop.
- Click Download for Windows.
- In your computer's Downloads folder, double-click the GitHub Desktop setup file.
- GitHub Desktop will launch after installation is complete.
Forking a Repository
The below information has been adapted from the Github docs.
A fork is a new repository that shares code and visibility settings with the original “upstream” repository. The below example is for the chia-docs repo but the same process can be followed for any of the public Chia-Network repos.
- On GitHub.com, navigate to the Chia-Network/chia-docs repository.
- In the top-right corner of the page, click Fork.
![Fork a Repository in Github](/zh-Hans/assets/images/fork-button-805068581ca1c21e44cb6796895512d3.webp)
- Under "Owner," select the dropdown menu and click an owner for the forked repository.
- By default, forks are named the same as their upstream repositories. Optionally, to further distinguish your fork, in the "Repository name" field, type a name.
- Optionally, in the "Description" field, type a description of your fork.
- Optionally, select Copy the DEFAULT branch only. For many forking scenarios, such as contributing to open-source projects, you only need to copy the default branch. If you do not select this option, all branches will be copied into the new fork.
- Click Create fork.
If you want to copy additional branches from the upstream repository, you can do so from the Branches page. For more information, see "Creating and deleting branches within your repository".