title

sources/tech/20220211 How to Fork a GitHub Repository – A Complete Workflow.md

@@ -0,0 +1,148 @@
+[#]: subject: "How to Fork a GitHub Repository – A Complete Workflow"
+[#]: via: "https://www.freecodecamp.org/news/how-to-fork-a-github-repository/"
+[#]: author: "TAPAS ADHIKARY https://www.freecodecamp.org/news/author/tapas/"
+[#]: collector: "lkxed"
+[#]: translator: " "
+[#]: reviewer: " "
+[#]: publisher: " "
+[#]: url: " "
+
+How to Fork a GitHub Repository – A Complete Workflow
+======
+
+`GitHub` is a great application that helps you manage your Git repositories. You can also use it to contribute to the open source ecosystem and collaborate with other contributors.
+
+Public repositories on GitHub often get lots of attention from contributors, and this helps enhance the project.
+
+So how can you easily work on a public repo? The repository `forking` tool lets contributors copy the source code repository locally and make any changes they would like.
+
+But if you're going to use this tool as a beginner, you need to understand the workflow of repository forking so you can seamlessly work with other public repositories.
+
+In this article, we will learn about how to fork a repo with practical examples and storytelling. If you like to learn from video content, this article is also available as a YouTube video.
+
+![A Video from YouTube][1]
+
+### What is GitHub Repository Forking?
+
+Suppose you love working on a particular framework or library like React.js. One fine day, you figure out a way that you can enhance the functionality of React yourself.
+
+React's source code is available as a public repository on GitHub, so you can make a local copy of it by `forking` it.
+
+Once you get the local copy of the code, you can make the relevant changes and ask the React community to review your changes.
+
+After reviewing your code changes, the React community may approve them or ask you for more changes. They are most likely to take your code changes after approval.
+
+So, let's understand the entire `forking` workflow with the story of two developers, Tom and Hari.
+
+### A Complete Forking Workflow
+
+Tom and Hari are two developers who have their individual GitHub accounts. Tom is working on an outstanding project, and he manages its source code in a public repository called `/tom/repo`. Hari is amazed by the idea and wants to contribute to the project.
+
+Now there are two ways Hari can approach it.
+
+* Hari asks Tom, "Hey Tom, I want to contribute to your project. Could you please add me as a Contributor?". Well, Tom may or may not agree. As the project is already available as a public repository, he may just ask to fork it and use it.
+* The second way is if Hari just forks the repo himself and starts working. He doesn't have to wait to talk to Tom and get Tom to add him as a contributor specifically.
+
+This second approach of `forking` a repository directly is more convenient for any contributor. So how does it work? Let's understand the workflow in steps.
+
+1. Hari forks the repository /tom/repo. We call the /tom/repo repository the Upstream Repository.
+2. The repository is now available in Hari's GitHub account as /hari/repo. We call the hari/repo the Forked Repository. Also, it is an exact copy of the upstream repository. This repository is entirely detached from Tom's repo and Hari can start making any changes he wants. Hari will first clone the repository and start making changes to do that.
+3. Hari makes the required changes and pushes the changes to the forked repository.
+4. Finally, Hari creates a Pull Request from the forked repository to the upstream repository. Tom reviews the pull request at his convenience to approve and merge it if all goes well.
+
+```
+/tom/repo
+```
+
+```
+/tom/repo
+```
+
+```
+Upstream Repository
+```
+
+```
+/hari/repo
+```
+
+```
+hari/repo
+```
+
+```
+Forked Repository
+```
+
+```
+Pull Request
+```
+
+That's the entire workflow—simple and straightforward ways to contribute to the public repository. A picture is worth thousands of words. Here is a demonstration of the workflow we discussed.
+
+![GitHub-Fork][2]
+
+### How to Fork a Repo in GitHub
+
+Forking a repository is the matter of clicking a button.
+
+To follow along, browse to a public repository that you want to fork. At the top right of the page, you will find the `Fork` button. Click on the button and wait for a few seconds. You will see that the newly forked repository gets created under your GitHub account.
+
+![image-29][3]
+
+Follow the steps we learned above after forking the repository to start contributing.
+
+### Let's Practice Forking
+
+As a newbie, do you want to practice `forking` to be more confident? Let's do that. You can perform these tasks to practice `forking`.
+
+* Browse to this public repository: https://github.com/atapas/fork-me
+* Create a folder with the same name as your GitHub user-id (it is atapas for me).
+* Add a Readme.md file inside the folder with any text of your choice.
+* Create a Pull Request upstream. I shall review and merge it if all is well.
+
+```
+Readme.md
+```
+
+```
+Pull Request
+```
+
+Don't worry if you go wrong. Keep trying, you will get it. It will be like a practice playground of contributing to an open-source repository.
+
+### In Summary
+
+* Git is a version control tool widely used by the developer community. If you are a beginner to Git, learn about it from here.
+* GitHub is a popular application for managing Git repositories. Anyone can contribute to a public repository.
+* Forking is an excellent tool for copying source code from someone's repository to your repository and contributing to it.
+* The forking workflow is simple to learn and get started.
+
+### Before We End...
+
+I hope you found the article helpful. Please practice forking and contribute to open source projects. My DMs are open on `Twitter` if you want to discuss further.
+
+Let's connect. I share my learnings on JavaScript, Web Development, Career, and Blogging on these platforms as well:
+
+* Follow me on Twitter
+* Subscribe to my YouTube Channel
+* Side projects on GitHub
+
+See you soon with my next article. Until then, please take care of yourself, and stay happy.
+
+--------------------------------------------------------------------------------
+
+via: https://www.freecodecamp.org/news/how-to-fork-a-github-repository/
+
+作者：[TAPAS ADHIKARY][a]
+选题：[lkxed][b]
+译者：[译者ID](https://github.com/译者ID)
+校对：[校对者ID](https://github.com/校对者ID)
+
+本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
+
+[a]: https://www.freecodecamp.org/news/author/tapas/
+[b]: https://github.com/lkxed
+[1]: https://youtu.be/h8suY-Osn8Q
+[2]: https://www.freecodecamp.org/news/content/images/2022/02/GitHub-Fork.gif
+[3]: https://www.freecodecamp.org/news/content/images/2022/02/image-29.png