diff --git a/content/get-started/quickstart/about-github-and-git.md b/content/get-started/quickstart/about-github-and-git.md new file mode 100644 index 000000000000..098c13d77a6e --- /dev/null +++ b/content/get-started/quickstart/about-github-and-git.md @@ -0,0 +1,75 @@ +--- +title: About GitHub and Git +shortTitle: About GitHub and Git +intro: 'You can use {% data variables.product.product_name %} and Git to collaborate on work.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +type: overview +topics: + - Git + - Fundamentals + - GitHub + - Collaboration + - Community +--- + +## About {% data variables.product.prodname_dotcom %} + +{% data variables.product.prodname_dotcom %} is a {% ifversion not ghes %}cloud-based {% endif %}platform where you can store, share, and work together with others to write code. + +Storing your code in a "repository" on {% data variables.product.prodname_dotcom %} allows you to: +- **Showcase or share** your work. +- **Track and manage** changes to your code over time. +- Let others **review** your code, and make suggestions to improve it. +- **Collaborate** on a shared project, without worrying that your changes will impact the work of your collaborators before you're ready to integrate them. + +Collaborative working, which is one of the most fundamental features of {% data variables.product.prodname_dotcom %}, is possible thanks to an open-source software called "Git," upon which {% data variables.product.prodname_dotcom %} is built. + +## About Git + +Git is a version control system that intelligently tracks changes in files. Git is particularly useful when you and a group of people are all making changes to the same files at the same time. + +Typically, to do this in a Git-based workflow, you would: +- **Create a branch** off from the main copy of files that you (and your collaborators) are working on. +- **Make edits** to the files independently and safely on your own personal branch. +- Let Git intelligently **merge** your specific changes back into the main copy of files, so that your changes don't impact other people's updates. +- Let Git **keep track** of your and other people's changes, so you all stay working on the most up-to-date version of the project. + +If you want to learn more about Git, see "[AUTOTITLE](/get-started/using-git/about-git)." + +### How do Git and {% data variables.product.prodname_dotcom %} work together? + +When you upload files to {% data variables.product.prodname_dotcom %}, you'll store them in a "Git repository." This means that when you make changes (or "commits") to your files in {% data variables.product.prodname_dotcom %}, Git will automatically start to track and manage your changes. + +There are plenty of Git-related actions that you can complete on {% data variables.product.prodname_dotcom %} directly in your browser, such as creating a Git repository, creating branches, and uploading and editing files. + +However, most people work on their files locally (on their own computer), then continually sync these local changes—and all the related Git data—with the central "remote" repository on {% data variables.product.prodname_dotcom %}. There are plenty of tools that you can use to do this, such as GitHub Desktop. + +Once you start to work collaboratively, where you and others all need to be making changes to the same repository at the same time, you'll continually: + +- **Pull** all the latest changes made by your collaborators from the remote repository on {% data variables.product.prodname_dotcom %}. +- **Push** back your own changes to the same remote repository on {% data variables.product.prodname_dotcom %}. + +Git figures out how to intelligently merge this flow of changes, and {% data variables.product.prodname_dotcom %} helps you manage the flow through features such as "pull requests." + +## Where do I start? + +If you're new to {% data variables.product.prodname_dotcom %}, and unfamiliar with Git, we recommend working through the articles in the "[Quickstart](/get-started/quickstart)" category, which will help you to: + +- **Create an account** on {% data variables.product.prodname_dotcom %}. +- **Learn the "{% data variables.product.prodname_dotcom %} Flow"**, and the key principles of collaborative working (branches, commits, pull requests, merges). +- **Find inspiration** on {% data variables.product.prodname_dotcom %} and learn how to **download** interesting code for your own use. + +{% ifversion fpt or ghec %} + +## Next steps + +- "[AUTOTITLE](/get-started/quickstart/creating-an-account-on-github)" + +{% endif %} + +## Further reading + +- "[AUTOTITLE](/get-started/using-github/connecting-to-github)" diff --git a/content/get-started/quickstart/index.md b/content/get-started/quickstart/index.md index db3f3c4f2e61..207aac12c210 100644 --- a/content/get-started/quickstart/index.md +++ b/content/get-started/quickstart/index.md @@ -12,6 +12,7 @@ topics: - Notifications - Accounts children: + - /about-github-and-git - /creating-an-account-on-github - /hello-world - /finding-inspiration-on-github diff --git a/data/reusables/support/ask-and-answer-forum.md b/data/reusables/support/ask-and-answer-forum.md index 8e69add43850..923b039be77d 100644 --- a/data/reusables/support/ask-and-answer-forum.md +++ b/data/reusables/support/ask-and-answer-forum.md @@ -1 +1 @@ -You can connect with developers around the world to ask and answer questions, learn, and interact directly with {% data variables.product.product_name %} staff. To get the conversation started, see "[{% data variables.product.prodname_gcf %}](https://github.community)." +You can connect with developers around the world to ask and answer questions, learn, and interact directly with {% data variables.product.product_name %} staff. To get the conversation started, see "[{% data variables.product.prodname_gcf %}](https://github.com/orgs/community/discussions/)."