Skip to content

Commit

Permalink
Merge pull request #31142 from github/repo-sync
Browse files Browse the repository at this point in the history
Repo sync
  • Loading branch information
docs-bot committed Jan 18, 2024
2 parents 0b66a9f + bffcfd9 commit af74cc1
Show file tree
Hide file tree
Showing 3 changed files with 77 additions and 1 deletion.
75 changes: 75 additions & 0 deletions content/get-started/quickstart/about-github-and-git.md
Original file line number Diff line number Diff line change
@@ -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)"
1 change: 1 addition & 0 deletions content/get-started/quickstart/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ topics:
- Notifications
- Accounts
children:
- /about-github-and-git
- /creating-an-account-on-github
- /hello-world
- /finding-inspiration-on-github
Expand Down
2 changes: 1 addition & 1 deletion data/reusables/support/ask-and-answer-forum.md
Original file line number Diff line number Diff line change
@@ -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/)."

0 comments on commit af74cc1

Please sign in to comment.