1
0
mirror of synced 2025-12-21 10:57:10 -05:00

Hello git history spelunker!

Are you looking for something? Here is all of the GitHub Docs history in one single commit. Enjoy! 🎉
This commit is contained in:
Vanessa Yuen
2020-09-27 14:10:11 +02:00
parent fa8bb2322f
commit 3df90fc9b8
28386 changed files with 1723440 additions and 3 deletions

View File

@@ -0,0 +1,38 @@
---
title: Access permissions on GitHub
redirect_from:
- /articles/needs-to-be-written-what-can-the-different-types-of-org-team-permissions-do/
- /articles/what-are-the-different-types-of-team-permissions/
- /articles/what-are-the-different-access-permissions/
- /articles/access-permissions-on-github
intro: 'While you can grant read/write access to collaborators on a personal repository, members of an organization can have more granular access permissions for the organization''s repositories.'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### Personal user accounts
A repository owned by a user account has two permission levels: the *repository owner* and *collaborators*. For more information, see "[Permission levels for a user account repository](/articles/permission-levels-for-a-user-account-repository)."
### Organization accounts
Organization members can have *owner*{% if currentVersion == "free-pro-team@latest" %}, *billing manager*,{% endif %} or *member* roles. Owners have complete administrative access to your organization{% if currentVersion == "free-pro-team@latest" %}, while billing managers can manage billing settings{% endif %}. Member is the default role for everyone else. You can manage access permissions for multiple members at a time with teams. For more information, see:
- "[Permission levels for an organization](/articles/permission-levels-for-an-organization)"
- "[Project board permissions for an organization](/articles/project-board-permissions-for-an-organization)"
- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)"
- "[About teams](/articles/about-teams)"
{% if currentVersion == "free-pro-team@latest" %}
### Enterprise accounts
*Enterprise owners* have ultimate power over the enterprise account and can take every action in the enterprise account. *Billing managers* can manage your enterprise account's billing settings. Members and outside collaborators of organizations owned by your enterprise account are automatically members of the enterprise account, although they have no access to the enterprise account itself or its settings. For more information, see "[Roles for an enterprise account](/articles/roles-for-an-enterprise-account)."
{{ site.data.reusables.gated-features.enterprise-accounts }}
{% endif %}
### Further reading
- "[Types of {{ site.data.variables.product.prodname_dotcom }} accounts](/articles/types-of-github-accounts)"

View File

@@ -0,0 +1,68 @@
---
title: Be social
redirect_from:
- /be-social/
- /articles/be-social
intro: 'You can interact with people, repositories, and organizations on {{ site.data.variables.product.prodname_dotcom }}. See what others are working on and who they''re connecting with from your personal dashboard.'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
To learn about accessing your personal dashboard, see "[About your personal dashboard](/articles/about-your-personal-dashboard)."
### Following people
When you follow someone on {{ site.data.variables.product.product_location }}, you'll get notifications on your personal dashboard about their activity. For more information, see "[About your personal dashboard](/articles/about-your-personal-dashboard)."
Click **Follow** on a person's profile page to follow them.
![Follow user button](/assets/images/help/profile/follow-user-button.png)
### Watching a repository
You can watch a repository to receive notifications for new pull requests and issues. When the owner updates the repository, you'll see the changes in your personal dashboard. For more information see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Viewing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions){% else %}"[Watching and unwatching repositories](/github/receiving-notifications-about-activity-on-github/watching-and-unwatching-repositories){% endif %}."
Click **Watch** at the top of a repository to watch it.
![Watch repository button](/assets/images/help/repository/repo-actions-watch.png)
### Joining the conversation
{{ site.data.reusables.support.ask-and-answer-forum }}
### Doing even more
#### Creating pull requests
You may want to contribute to another person's project, whether to add features or to fix bugs. After making changes, let the original author know by sending a pull request. For more information, see "[About pull requests](/articles/about-pull-requests)."
![Pull request button](/assets/images/help/repository/repo-actions-pullrequest.png)
#### Using issues
When collaborating on a repository, use issues to track ideas, enhancements, tasks, or bugs. For more information, see '[About issues](/articles/about-issues/)."
![Issues button](/assets/images/help/repository/repo-tabs-issues.png)
#### Participating in organizations
Organizations are shared accounts where businesses and open-source projects can collaborate across many projects at once. Owners and administrators can establish teams with special permissions, have a public organization profile, and keep track of activity within the organization. For more information, see "[About organizations](/articles/about-organizations/)."
![Switch account context dropdown](/assets/images/help/overview/dashboard-contextswitcher.png)
#### Exploring other projects on {{ site.data.variables.product.prodname_dotcom }}
Discover interesting projects using {{ site.data.variables.explore.explore_github }}, [Explore repositories](https://github.com/explore), and the {{ site.data.variables.explore.trending_page }}. Star interesting projects and come back to them later. Visit your {{ site.data.variables.explore.your_stars_page }} to see all your starred projects. For more information, see "[About your personal dashboard](/articles/about-your-personal-dashboard/)."
### Celebrate
You're now connected to the {{ site.data.variables.product.product_name }} community. What do you want to do next?
![Star a project](/assets/images/help/stars/star-a-project.png)
- [Set up Git](/articles/set-up-git)
- [Create a repository](/articles/create-a-repo)
- [Fork a repository](/articles/fork-a-repo)
- **Be social**
- {{ site.data.reusables.support.connect-in-the-forum-bootcamp }}

View File

@@ -0,0 +1,67 @@
---
title: Create a repo
redirect_from:
- /create-a-repo/
- /articles/create-a-repo
intro: 'To put your project up on {{ site.data.variables.product.product_location }}, you''ll need to create a repository for it to live in.'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
You can store a variety of projects in {{ site.data.variables.product.product_name }} repositories, including open source projects. With [open source projects](http://opensource.org/about), you can share code to make better, more reliable software.
{% note %}
**Note:** You can create public repositories for an open source project. When creating your public repository, make sure to include a [license file](http://choosealicense.com/) that determines how you want your project to be shared with others. {{ site.data.reusables.open-source.open-source-guide-repositories }} {{ site.data.reusables.open-source.open-source-learning-lab }}
{% endnote %}
{{ site.data.reusables.repositories.create_new }}
2. Type a short, memorable name for your repository. For example, "hello-world".
![Field for entering a repository name](/assets/images/help/repository/create-repository-name.png)
3. Optionally, add a description of your repository. For example, "My first repository on {{ site.data.variables.product.product_name }}."
![Field for entering a repository description](/assets/images/help/repository/create-repository-desc.png)
{{ site.data.reusables.repositories.choose-repo-visibility }}
{{ site.data.reusables.repositories.initialize-with-readme }}
{{ site.data.reusables.repositories.create-repo }}
Congratulations! You've successfully created your first repository, and initialized it with a *README* file.
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
{% tip %}
**Tip**: You can also create repositories using the {{ site.data.variables.product.prodname_cli }}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {{ site.data.variables.product.prodname_cli }} documentation.
{% endtip %}
{% endif %}
### Commit your first change
A *[commit](/articles/github-glossary#commit)* is like a snapshot of all the files in your project at a particular point in time.
When you created your new repository, you initialized it with a *README* file. *README* files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your *README* file are automatically shown on the front page of your repository.
Let's commit a change to the *README* file.
1. In your repository's list of files, click ***README.md***.
![Readme file in file list](/assets/images/help/repository/create-commit-open-readme.png)
2. Above the file's content, click {% octicon "pencil" aria-label="The edit icon" %}.
3. On the **Edit file** tab, type some information about yourself.
![New content in file](/assets/images/help/repository/edit-readme-light.png)
{{ site.data.reusables.files.preview_change }}
5. Review the changes you made to the file. You'll see the new content in green.
![File preview view](/assets/images/help/repository/create-commit-review.png)
{{ site.data.reusables.files.write_commit_message }}
{{ site.data.reusables.files.choose_commit_branch }}
{{ site.data.reusables.files.propose_file_change }}
### Celebrate
Congratulations! You have now created a repository, including a *README* file, and created your first commit on {{ site.data.variables.product.product_location }}. What do you want to do next?
- "[Set up Git](/articles/set-up-git)"
- **Create a repository**
- "[Fork a repository](/articles/fork-a-repo)"
- "[Be social](/articles/be-social)"
- {{ site.data.reusables.support.connect-in-the-forum-bootcamp }}

View File

@@ -0,0 +1,27 @@
---
title: Exploring early access releases with feature preview
intro: You can use feature preview to see products or features that are available in beta and to enable or disable each feature for your user account.
redirect_from:
- /articles/exploring-early-access-releases-with-feature-preview
versions:
free-pro-team: '*'
---
### {{ site.data.variables.product.prodname_dotcom }}'s release cycle
{{ site.data.variables.product.product_name }}'s products and features can go through multiple release phases.
| Phase | Description |
|-------|-------------|
| Alpha | The product or feature is under heavy development and often has changing requirements and scope. The feature is available for demonstration and test purposes but may not be documented. Alpha releases are not necessarily feature complete, no service level agreements (SLAs) are provided, and there are no technical support obligations. |
| Beta | The product or feature is ready for broader distribution. Beta releases can be public or private, are documented, but do not have any SLAs or technical support obligations. |
| General availability (GA) | The product or feature is fully tested and open publicly to all users. GA releases are ready for production use, and associated SLA and technical support obligations apply. |
### Exploring beta releases with feature preview
You can see a list of features that are available in beta and a brief description for each feature. Each feature includes a link to give feedback.
1. In the upper-right corner of any page, click your profile photo, then click **Feature preview**.
![Feature preview button](/assets/images/help/settings/feature-preview-button.png)
2. Optionally, to the right of a feature, click **Enable** or **Disable**.
![Enable button in feature preview](/assets/images/help/settings/enable-feature-button.png)

View File

@@ -0,0 +1,14 @@
---
title: Exploring projects on GitHub
intro: ''
mapTopic: true
redirect_from:
- /categories/stars/
- /categories/87/articles/
- /categories/exploring-projects-on-github/
- /articles/exploring-projects-on-github
versions:
free-pro-team: '*'
enterprise-server: '*'
---

View File

@@ -0,0 +1,90 @@
---
title: FAQ about changes to GitHubs plans
intro: 'As of April 14, 2020, GitHub announced that all of the core GitHub features are now free for everyone.'
versions:
free-pro-team: '*'
---
### What plans and pricing changes did GitHub announce on April 14?
GitHub announced the following plans and pricing changes:
- GitHub Free for organizations is immediately available and includes private repositories for unlimited users
- All organizations previously using Team for Open Source now have GitHub Free
- GitHub Free for individual developers now includes unlimited collaborators
- Organizations and individuals using GitHub Free will receive GitHub Community Support
- GitHub Pro will now include 2GB of Packages storage and 10GB of data transfer
- GitHub Pro now has a reduced monthly price of $4
- GitHub Team now has a reduced monthly price of $4 per user
- GitHub Team no longer has a required five-seat minimum
- GitHub Team includes 3,000 Actions minutes per month for private repositories
### How can I upgrade my plan?
To upgrade your user account's plan, see "[Upgrading your personal account's subscription](/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription#upgrading-your-personal-accounts-subscription)." To upgrade your organization's plan, see "[Upgrading your organization's subscription](/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-your-github-subscription#upgrading-your-organizations-subscription)."
### How can I downgrade my plan?
To downgrade your user account's plan, see "[Downgrading your user account's subscription](/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription#downgrading-your-user-accounts-subscription)." To downgrade your organization's plan, see "[Downgrading your organization's subscription](/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription#downgrading-your-organizations-subscription)."
### If I downgrade from GitHub Team or a Legacy plan to GitHub Free, what features will I lose?
- Required reviewers in private repositories
- Protected branches in private repositories
- Code owners in private repositories
- GitHub Pages in private repositories
- Wikis in private repositories
- Multiple assignees for issues and pull requests in private repositories
- Multiple pull request reviewers in private repositories
- Draft pull requests in private repositories
- Autolinked references in private repositories
- Standard support
### How can I create a GitHub Free or GitHub Team organization?
If you have a GitHub account, create a new organization on our [team plan page](https://github.com/organizations/plan). If you dont have a GitHub account, you can [create one on our homepage](https://github.com/) and youll be prompted to create an organization during the sign-up process.
### How can I compare which features are in each plan?
You can see pricing and a full list of features for each product at <{{ site.data.variables.product.pricing_url }}>.
### How long will GitHub Free allow unlimited collaborators?
Forever! This change is permanent.
### I already paid for the yearly Pro or Team plan, do I get a refund for the price difference?
Customers who are currently paying annually for Pro and Team plans and signed up before April 14 will receive a refund for a prorated amount through the end of their annual billing term. For example, if you are two months into your subscription that is billed annually, you will receive a refund for the price difference for the remaining ten months. These refunds will be processed in approximately 30 days. Once your refund is processed, a notification will be sent to the billing email.
### What is the difference between GitHub Free for individual developers and GitHub Free for organizations?
For details on the differences for each GitHub Free product, see "[{{ site.data.variables.product.prodname_dotcom }}'s products](/articles/github-s-products)."
### How can I get more Actions minutes if I need more than allocated in the GitHub Team plan?
Most small teams use fewer than 3,000 Actions minutes/month, but some teams might use more. If your team needs additional minutes for private repositories, you can increase your spending limit for GitHub Actions. Actions minutes and Packages storage are still free for your public repositories. For more information, see "[Managing your spending limit for GitHub Actions](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions)."
### How do the seat limit changes affect me?
Now that {{ site.data.variables.product.prodname_team }} has no minimum seat requirement, if you are using fewer than five seats in your organization, you can remove paid seats to reduce your bill. For more information, see "[Downgrading your {{ site.data.variables.product.prodname_dotcom }} subscription](/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-your-github-subscription#removing-paid-seats-from-your-organization)."
### Is anything changing for teams on the GitHub Team for Open Source plan?
If your organization account currently uses the GitHub Team for Open Source plan, youve been automatically moved to GitHub Free, which includes private repositories with unlimited collaborators, 2,000 Actions minutes for private repositories, and GitHub Community Support. Actions minutes and Packages storage are still free for your public repositories.
### What is GitHub Community Support?
GitHub Community Support includes support through our [Community Forum](https://github.community/), where you can browse solutions from the GitHub community, ask new questions, and share ideas. GitHub Community Support is staffed by Support Engineers on the GitHub Team, who moderate the Community Forum along with our most active community members. If you need to report spam, report abuse, or have issues with account access, you can send a message to our Support Team on https://support.github.com/.
### How does this change affect education benefits?
Students and teachers will continue to receive all of the benefits they get today. GitHub will continue to offer GitHub Pro as part of its [Student Developer Pack](https://education.github.com/pack) benefits to all students. Additionally, teachers will continue to have access to GitHub Team as part of the [Teacher Toolbox](https://education.github.com/toolbox).
### How does this affect me if I currently pay by invoice?
If youre currently an invoice customer, email your sales representative for additional details. If youre not sure who your sales representative is, contact your billing manager or account owner.
### How will this impact users and organizations in regions where U.S. government sanctions are applied?
Due to U.S. trade controls law restrictions, GitHub is unable to provide private repository services and paid services to accounts in U.S. sanctioned regions. GitHub has preserved, however, access to free public repository services. Please read about [GitHub and Trade Controls](/github/site-policy/github-and-trade-controls) for more information.
GitHub will continue advocating with U.S. regulators for the greatest possible access to free code collaboration services to developers in sanctioned regions, including free private repositories. We believe that offering those free services supports U.S. foreign policy of encouraging the free flow of information and free speech in those regions.

View File

@@ -0,0 +1,52 @@
---
title: Finding ways to contribute to open source on GitHub
intro: 'You can find ways to contribute to open source projects on {{ site.data.variables.product.product_name }} that are relevant to you.'
redirect_from:
- /articles/where-can-i-find-open-source-projects-to-work-on/
- /articles/finding-interesting-projects-on-github/
- /articles/about-official-github-mirrors/
- /articles/about-github-mirrors/
- /articles/finding-open-source-projects-on-github
- /github/getting-started-with-github/finding-open-source-projects-on-github
versions:
free-pro-team: '*'
---
### Discovering relevant projects
If there's a particular topic that interests you, visit `github.com/topics/<topic>`. For example, if you are interested in machine learning, you can find relevant projects and good first issues by visiting https://github.com/topics/machine-learning. You can browse popular topics by visiting [Topics](https://github.com/topics). You can also search for repositories that match a topic you're interested in. For more information, see "[Searching for repositories](/articles/searching-for-repositories#search-by-topic)."
If you've been active on {{ site.data.variables.product.product_name }}, you can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in [Explore](https://github.com/explore). You can also sign up for the Explore newsletter to receive emails about opportunities to contribute to {{ site.data.variables.product.product_name }} based on your interests. To sign up, see [Explore email newsletter](https://github.com/explore/subscribe).
Keep up with recent activity from repositories you watch and people you follow in the "All activity" section of your personal dashboard. For more information, see "[About your personal dashboard](/articles/about-your-personal-dashboard)."
{{ site.data.reusables.support.ask-and-answer-forum }}
### Finding good first issues
If you already know what project you want to work on, you can find beginner-friendly issues in that repository by visiting `github.com/<owner>/<repository>/contribute`. For an example, you can find ways to make your first contribution to `electron/electron` at https://github.com/electron/electron/contribute.
### Open source projects with mirrors on {{ site.data.variables.product.prodname_dotcom }}
Some open-source projects provide mirrors on {{ site.data.variables.product.prodname_dotcom_the_website }} in addition to their official repositories, which are hosted elsewhere.
Here are a few prominent repositories that are mirrored on {{ site.data.variables.product.prodname_dotcom_the_website }}:
- [android](https://github.com/android)
- [The Apache Software Foundation](https://github.com/apache)
- [The Chromium Project](https://github.com/chromium)
- [The Eclipse Foundation](https://github.com/eclipse)
- [The FreeBSD Project](https://github.com/freebsd)
- [The Glasgow Haskell Compiler](https://github.com/ghc)
- [GNOME](https://github.com/GNOME)
- [The Linux kernel source tree](https://github.com/torvalds/linux)
- [Qt](https://github.com/qt)
To set up your own mirror, you can configure [a post-receive hook](https://git-scm.com/book/en/Customizing-Git-Git-Hooks) on your official project repository to automatically push commits to a mirror repository on {{ site.data.variables.product.product_name }}.
You can search repositories based on whether they're a mirror. To learn more, see "[Searching for repositories](/articles/searching-for-repositories/#search-based-on-whether-a-repository-is-a-mirror)."
### Further reading
- "[Classifying your repository with topics](/articles/classifying-your-repository-with-topics)"
- "[About your organization dashboard](/articles/about-your-organization-dashboard)"

View File

@@ -0,0 +1,22 @@
---
title: Following people
intro: 'You can follow people on {{ site.data.variables.product.product_name }} to receive notifications about their activity{% if currentVersion == "free-pro-team@latest" %} and discover projects in their communities{% endif %}.'
redirect_from:
- /articles/following-people
versions:
free-pro-team: '*'
enterprise-server: '*'
---
When you follow people, you'll see their public activity in the activity view of your news feed.{% if currentVersion == "free-pro-team@latest" %} If someone you follow stars a public repository, {{ site.data.variables.product.product_name }} may recommend the repository to you in the discovery view of your news feed.{% endif %} To follow someone, visit their profile page and click **Follow** under their profile image.
![Follow user button](/assets/images/help/profile/follow-user-button.png)
To stop following someone, visit their profile page and click **Unfollow** under their profile image.
{% if currentVersion == "free-pro-team@latest" %}
### Further reading
- "[Saving repositories with stars](/articles/saving-repositories-with-stars/)"
- "[Finding ways to contribute to open source on {{ site.data.variables.product.prodname_dotcom }}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)"
{% endif %}

View File

@@ -0,0 +1,143 @@
---
title: Fork a repo
redirect_from:
- /fork-a-repo/
- /forking/
- /articles/fork-a-repo
intro: A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
versions:
free-pro-team: '*'
enterprise-server: '*'
---
Most commonly, forks are used to either propose changes to someone else's project or to use someone else's project as a starting point for your own idea.
#### Propose changes to someone else's project
For example, you can use forks to propose changes related to fixing a bug. Rather than logging an issue for a bug you've found, you can:
- Fork the repository.
- Make the fix.
- Submit a pull request to the project owner.
#### Use someone else's project as a starting point for your own idea.
Open source software is based on the idea that by sharing code, we can make better, more reliable software. For more information, see the "[About the Open Source Initiative](http://opensource.org/about)" on the Open Source Initiative.
When creating your public repository from a fork of someone's project, make sure to include a license file that determines how you want your project to be shared with others. For more information, see "[Choose an open source license](http://choosealicense.com/)" at choosealicense.
{{ site.data.reusables.open-source.open-source-guide-repositories }} {{ site.data.reusables.open-source.open-source-learning-lab }}
{% note %}
**Note**: {{ site.data.reusables.repositories.desktop-fork }}
{% endnote %}
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
{% tip %}
**Tip**: You can also fork a repository using the {{ site.data.variables.product.prodname_cli }}. For more information, see "[`gh repo fork`](https://cli.github.com/manual/gh_repo_fork)" in the {{ site.data.variables.product.prodname_cli }} documentation.
{% endtip %}
{% endif %}
### Fork an example repository
Forking a repository is a simple two-step process. We've created a repository for you to practice with.
1. On {{ site.data.variables.product.product_location }}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository.
2. In the top-right corner of the page, click **Fork**.
![Fork button](/assets/images/help/repository/fork_button.jpg)
### Keep your fork synced
You might fork a project to propose changes to the upstream, or original, repository. In this case, it's good practice to regularly sync your fork with the upstream repository. To do this, you'll need to use Git on the command line. You can practice setting the upstream repository using the same [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository you just forked.
#### Step 1: Set up Git
If you haven't yet, you should first [set up Git](/articles/set-up-git). Don't forget to [set up authentication to {{ site.data.variables.product.product_location }} from Git](/articles/set-up-git#next-steps-authenticating-with-github-from-git) as well.
#### Step 2: Create a local clone of your fork
Right now, you have a fork of the Spoon-Knife repository, but you don't have the files in that repository on your computer. Let's create a clone of your fork locally on your computer.
1. On {{ site.data.variables.product.product_name }}, navigate to **your fork** of the Spoon-Knife repository.
{{ site.data.reusables.repositories.copy-clone-url }}
{{ site.data.reusables.command_line.open_the_multi_os_terminal }}
{{ site.data.reusables.command_line.change-current-directory-clone }}
4. Type `git clone`, and then paste the URL you copied earlier. It will look like this, with your {{ site.data.variables.product.product_name }} username instead of `YOUR-USERNAME`:
```shell
$ git clone https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR-USERNAME</em>/Spoon-Knife
```
5. Press **Enter**. Your local clone will be created.
```shell
$ git clone https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR-USERNAME</em>/Spoon-Knife
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remove: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.
```
Now, you have a local copy of your fork of the Spoon-Knife repository.
#### Step 3: Configure Git to sync your fork with the original Spoon-Knife repository
When you fork a project in order to propose changes to the original repository, you can configure Git to pull changes from the original, or upstream, repository into the local clone of your fork.
1. On {{ site.data.variables.product.product_name }}, navigate to the [octocat/Spoon-Knife](https://github.com/octocat/Spoon-Knife) repository.
{{ site.data.reusables.repositories.copy-clone-url }}
{{ site.data.reusables.command_line.open_the_multi_os_terminal }}
4. Change directories to the location of the fork you cloned in [Step 2: Create a local clone of your fork](#step-2-create-a-local-clone-of-your-fork).
- To go to your home directory, type just `cd` with no other text.
- To list the files and folders in your current directory, type `ls`.
- To go into one of your listed directories, type `cd your_listed_directory`.
- To go up one directory, type `cd ..`.
5. Type `git remote -v` and press **Enter**. You'll see the current configured remote repository for your fork.
```shell
$ git remote -v
> origin https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (fetch)
> origin https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (push)
```
6. Type `git remote add upstream`, and then paste the URL you copied in Step 2 and press **Enter**. It will look like this:
```shell
$ git remote add upstream https://{{ site.data.variables.command_line.codeblock }}/octocat/Spoon-Knife.git
```
7. To verify the new upstream repository you've specified for your fork, type `git remote -v` again. You should see the URL for your fork as `origin`, and the URL for the original repository as `upstream`.
```shell
$ git remote -v
> origin https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (fetch)
> origin https://{{ site.data.variables.command_line.codeblock }}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (push)
> upstream https://{{ site.data.variables.command_line.codeblock }}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>.git (fetch)
> upstream https://{{ site.data.variables.command_line.codeblock }}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>.git (push)
```
Now, you can keep your fork synced with the upstream repository with a few Git commands. For more information, see "[Syncing a fork](/articles/syncing-a-fork)."
#### Next steps
You can make any changes to a fork, including:
- **Creating branches:** [*Branches*](/articles/creating-and-deleting-branches-within-your-repository/) allow you to build new features or test out ideas without putting your main project at risk.
- **Opening pull requests:** If you are hoping to contribute back to the original repository, you can send a request to the original author to pull your fork into their repository by submitting a [pull request](/articles/about-pull-requests).
### Find another repository to fork
Fork a repository to start contributing to a project. {{ site.data.reusables.repositories.you-can-fork }}
{% if currentVersion == "free-pro-team@latest" %}You can browse [Explore](https://github.com/explore) to find projects and start contributing to open source repositories. For more information, see "[Finding ways to contribute to open source on {{ site.data.variables.product.prodname_dotcom }}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."
{% endif %}
### Celebrate
You have now forked a repository, practiced cloning your fork, and configured an upstream repository. What do you want to do next?
- "[Set up Git](/articles/set-up-git)"
- "[Create a repository](/articles/create-a-repo)"
- "[Be social](/articles/be-social)"
- {{ site.data.reusables.support.connect-in-the-forum-bootcamp }}

View File

@@ -0,0 +1,59 @@
---
title: Git and GitHub learning resources
redirect_from:
- /articles/good-resources-for-learning-git-and-github/
- /articles/what-are-other-good-resources-for-learning-git-and-github/
- /articles/git-and-github-learning-resources
intro: 'There are a lot of helpful Git and {{ site.data.variables.product.product_name }} resources on the web. This is a short list of our favorites!'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### Using Git
Familiarize yourself with Git by visiting the [official Git project site](https://git-scm.com) and reading the [ProGit ebook](http://git-scm.com/book). You can review the [Git command list](https://git-scm.com/docs) or [Git command lookup reference](http://gitref.org) while using the [Try Git](https://try.github.com) simulator.
### Using {{ site.data.variables.product.product_name }}
{% if currentVersion == "free-pro-team@latest" %}
{{ site.data.variables.product.prodname_learning }} offers free interactive courses that are built into {{ site.data.variables.product.prodname_dotcom }} with instant automated feedback and help. Learn to open your first pull request, make your first open source contribution, create a {{ site.data.variables.product.prodname_pages }} site, and more. For more information about course offerings, see [{{ site.data.variables.product.prodname_learning }}]({{ site.data.variables.product.prodname_learning_link }}).
{% endif %}
Become better acquainted with {{ site.data.variables.product.product_name }} through our [bootcamp](/categories/bootcamp/) articles. See our [{{ site.data.variables.product.prodname_dotcom }} flow](https://guides.github.com/introduction/flow) for a process introduction. Refer to our [overview guides](https://guides.github.com) to walk through basic concepts.
{{ site.data.reusables.support.ask-and-answer-forum }}
#### Branches, forks, and pull requests
Learn about [Git branching](http://learngitbranching.js.org/) using an interactive tool. Read about [forks](/articles/about-forks) and [pull requests](/articles/using-pull-requests) as well as [how we use pull requests](https://github.com/blog/1124-how-we-use-pull-requests-to-build-github) at {{ site.data.variables.product.prodname_dotcom }}.
Access quick references about the [command line](https://hub.github.com) as well as {{ site.data.variables.product.prodname_dotcom }} [checklists, cheat sheets, and more](https://services.github.com/on-demand/resources).
#### Tune in
Our {{ site.data.variables.product.prodname_dotcom }} [YouTube Training and Guides channel](https://youtube.com/githubguides) offers tutorials about [pull requests](https://www.youtube.com/watch?v=d5wpJ5VimSU&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=19), [forking](https://www.youtube.com/watch?v=5oJHRbqEofs), [rebase](https://www.youtube.com/watch?v=SxzjZtJwOgo&list=PLg7s6cbtAD15G8lNyoaYDuKZSKyJrgwB-&index=22), and [reset](https://www.youtube.com/watch?v=BKPjPMVB81g) functions. Each topic is covered in 5 minutes or less.
### Training
#### Free classes
{{ site.data.variables.product.product_name }} offers a series of interactive, [on-demand training courses](https://services.github.com/on-demand/) including {{ site.data.variables.product.prodname_dotcom }} 101: [Introduction](https://services.github.com/on-demand/intro-to-github/), {{ site.data.variables.product.prodname_dotcom }} 102: [GitHub Desktop](https://services.github.com/on-demand/github-desktop), and {{ site.data.variables.product.prodname_dotcom }} 103: [Command Line](https://services.github.com/on-demand/github-cli).
#### {{ site.data.variables.product.prodname_dotcom }}'s web-based educational programs
{{ site.data.variables.product.prodname_dotcom }} offers live [trainings](https://services.github.com/#upcoming-events) with a hands-on, project-based approach for those who love the command line and those who don't.
#### Training for your company
{{ site.data.variables.product.prodname_dotcom }} offers [in-person classes](https://services.github.com/#offerings) taught by our highly-experienced educators. [Contact us](https://services.github.com/#contact) to ask your training-related questions.
### Extras
An interactive [online Git course](http://www.codeschool.com/courses/git-real) from [Code School](http://codeschool.com) has seven levels with dozens of exercises in a fun game format. Feel free to adapt our [.gitignore templates](https://github.com/github/gitignore) to meet your needs.
Extend your {{ site.data.variables.product.prodname_dotcom }} reach through {% if currentVersion == "free-pro-team@latest" %}[integrations](/articles/about-integrations){% else %}integrations{% endif %}, or by installing [{{ site.data.variables.product.prodname_desktop }}](https://desktop.github.com) and the robust [Atom](https://atom.io) text editor.
Learn how to launch and grow your open source project with the [Open Source Guides](https://opensource.guide/).

View File

@@ -0,0 +1,11 @@
---
title: Git cheatsheet
redirect_from:
- /articles/git-cheatsheet
versions:
free-pro-team: '*'
enterprise-server: '*'
---
Learning all available Git commands at once can be a daunting task. Keep one of our [Git Cheat Sheets](https://services.github.com/on-demand/resources/cheatsheets/) nearby for reference. The Using Git Cheat Sheet is available in several languages. For more information, see the [resources page on the GitHub Services website](https://services.github.com/on-demand/resources/).
In addition, take a look at our [Git and GitHub learning resources](/articles/git-and-github-learning-resources/) page that links to guides, videos and more.

View File

@@ -0,0 +1,28 @@
---
title: GitHub CLI
intro: 'The {{ site.data.variables.product.prodname_cli }} is a command-line tool for using {{ site.data.variables.product.product_name }} features on your computer.'
versions:
free-pro-team: '*'
enterprise-server: '>2.19'
---
### About {{ site.data.variables.product.prodname_cli }}
{{ site.data.variables.product.prodname_cli }} is an open source tool for using {{ site.data.variables.product.product_name }} from your computer's command line. When you're working from the command line, you can use the {{ site.data.variables.product.prodname_cli }} to save time and avoid switching context.
You can use the following {{ site.data.variables.product.prodname_dotcom }} features with the {{ site.data.variables.product.prodname_cli }}.
- View, create, clone, and fork repositories
- Create, close, and list issues and pull requests
- Review, diff, and merge pull requests
- Create, edit, list, and view gists
For more information about what you can do with {{ site.data.variables.product.prodname_cli }}, see the [{{ site.data.variables.product.prodname_cli }} manual](https://cli.github.com/manual).
### Installing {{ site.data.variables.product.prodname_cli }}
View installation instructions {{ site.data.variables.product.prodname_cli }} for macOS, Windows, and Linux on the [{{ site.data.variables.product.prodname_cli }} page](https://cli.github.com).
### Sharing feedback
If you have feedback or feature requests, you can open an issue in the [`cli/cli` repository](https://github.com/cli/cli).

View File

@@ -0,0 +1,17 @@
---
title: GitHub Desktop
intro: '{{ site.data.variables.product.prodname_desktop }} extends and simplifies your Git and {{ site.data.variables.product.prodname_dotcom }} workflow using a visual interface.'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### About {{ site.data.variables.product.prodname_desktop }}
{{ site.data.reusables.desktop.about-github-desktop }}
For more information about {{ site.data.variables.product.prodname_desktop }}, see "[Installing and configuring {{ site.data.variables.product.prodname_desktop }}](/desktop/installing-and-configuring-github-desktop)" in the {{ site.data.variables.product.prodname_desktop }} documentation.
### Sharing feedback
If you have feedback or feature requests, you can open an issue in the [`desktop/desktop` repository](https://github.com/desktop/desktop).

View File

@@ -0,0 +1,45 @@
---
title: GitHub for mobile
intro: 'Triage, collaborate, and manage your work on {{ site.data.variables.product.company_short }} from your mobile device.'
versions:
free-pro-team: '*'
---
### About {{ site.data.variables.product.prodname_mobile }}
{{ site.data.variables.product.prodname_mobile }} is currently available for {{ site.data.variables.product.prodname_dotcom_the_website }} users as an Android and iOS app.
{{ site.data.variables.product.prodname_mobile }} gives you a way to do high-impact work on {{ site.data.variables.product.prodname_dotcom }} quickly and from anywhere. {{ site.data.variables.product.prodname_mobile }} is a safe and secure way to access your {{ site.data.variables.product.prodname_dotcom }} data through a trusted, first-party client application.
With {{ site.data.variables.product.prodname_mobile }} you can:
- Manage, triage, and clear notifications
- Read, review, and collaborate on issues and pull requests
- Search for, browse, and interact with users, repositories, and organizations
- Receive a push notification when someone mentions your username
For more information about notifications for {{ site.data.variables.product.prodname_mobile }}, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)."
### Installing {{ site.data.variables.product.prodname_mobile }}
To install {{ site.data.variables.product.prodname_mobile }} for Android or iOS, see [{{ site.data.variables.product.prodname_mobile }}](https://github.com/mobile).
### Managing Universal Links for {{ site.data.variables.product.prodname_mobile }} on iOS
{{ site.data.variables.product.prodname_mobile }} automatically enables Universal Links for iOS. When you tap any {{ site.data.variables.product.product_name }} link, the destination URL will open in {{ site.data.variables.product.prodname_mobile }} instead of Safari. For more information, see [Universal Links](https://developer.apple.com/ios/universal-links/) on the Apple Developer site.
To disable Universal Links, long-press any {{ site.data.variables.product.prodname_dotcom }} link, then tap **Open**. Every time you tap a {{ site.data.variables.product.prodname_dotcom }} link in the future, the destination URL will open in Safari instead of {{ site.data.variables.product.prodname_mobile }}.
To re-enable Universal Links, long-press any {{ site.data.variables.product.prodname_dotcom }} link, then tap **Open in {{ site.data.variables.product.prodname_dotcom }}**.
### Sharing feedback
If you have feedback or feature requests for {{ site.data.variables.product.prodname_mobile }}, you can email us at <a href="mailto:mobilefeedback@github.com">mobilefeedback@github.com</a>.
### Opting out of beta releases for iOS
If you're testing a beta release of {{ site.data.variables.product.prodname_mobile }} for iOS using TestFlight, you can leave the beta at any time.
1. On your iOS device, open the TestFlight app.
2. Under "Apps", tap **{{ site.data.variables.product.prodname_dotcom }}**.
3. At the bottom of the page, tap **Stop Testing**.

View File

@@ -0,0 +1,23 @@
---
title: GitHub glossary
intro: 'Below are a list of some Git and {{ site.data.variables.product.prodname_dotcom }} specific terms we use across our sites and documentation.'
redirect_from:
- /articles/github-glossary
versions:
free-pro-team: '*'
enterprise-server: '*'
---
{% for term in site.data.glossaries.external %}
### {{term.term}}
{{term.description}}
---
{% endfor %}
---
### Further reading
- [The Official Git Glossary](https://www.kernel.org/pub/software/scm/git/docs/gitglossary.html)
- [Git Reference](http://gitref.org/)
- [Git SCM](https://git-scm.com/doc)

View File

@@ -0,0 +1,102 @@
---
title: GitHub's products
redirect_from:
- /articles/github-s-products
- /articles/githubs-products
versions:
free-pro-team: '*'
enterprise-server: '*'
---
{{ site.data.variables.product.prodname_dotcom }} offers free and paid products. You can see pricing and a full list of features for each product at <{{ site.data.variables.product.pricing_url }}>. {{ site.data.reusables.products.product-roadmap }}
### {{ site.data.variables.product.prodname_free_user }} for user accounts
With {{ site.data.variables.product.prodname_free_team }} for user accounts, you can work with unlimited collaborators on unlimited public repositories with a full feature set, and on unlimited private repositories with a limited feature set.
With {{ site.data.variables.product.prodname_free_user }}, your user account includes:
- {{ site.data.variables.product.prodname_gcf }}
- {{ site.data.variables.product.prodname_dependabot_alerts }}
- Two-factor authentication enforcement
- 2,000 {{ site.data.variables.product.prodname_actions }} minutes
- 500MB {{ site.data.variables.product.prodname_registry }} storage
### {{ site.data.variables.product.prodname_pro }}
In addition to the features available with {{ site.data.variables.product.prodname_free_user }} for user accounts, {{ site.data.variables.product.prodname_pro }} includes:
- {{ site.data.variables.contact.github_support }} via email
- 3,000 {{ site.data.variables.product.prodname_actions }} minutes
- 2GB {{ site.data.variables.product.prodname_registry }} storage
- Advanced tools and insights in private repositories:
- Required pull request reviewers
- Multiple pull request reviewers
- Auto-linked references
- {{ site.data.variables.product.prodname_pages }}
- Wikis
- Protected branches
- Code owners
- Repository insights graphs: Pulse, contributors, traffic, commits, code frequency, network, and forks
### {{ site.data.variables.product.prodname_free_team }} for organizations
With {{ site.data.variables.product.prodname_free_team }} for organizations, you can work with unlimited collaborators on unlimited public repositories with a full feature set, or unlimited private repositories with a limited feature set.
In addition to the features available with {{ site.data.variables.product.prodname_free_user }} for user accounts, {{ site.data.variables.product.prodname_free_team }} for organizations includes:
- {{ site.data.variables.product.prodname_gcf }}
- Team discussions
- Team access controls for managing groups
- 2,000 {{ site.data.variables.product.prodname_actions }} minutes
- 500MB {{ site.data.variables.product.prodname_registry }} storage
### {{ site.data.variables.product.prodname_team }}
In addition to the features available with {{ site.data.variables.product.prodname_free_team }} for organizations, {{ site.data.variables.product.prodname_team}} includes:
- {{ site.data.variables.contact.github_support }} via email
- 3,000 {{ site.data.variables.product.prodname_actions }} minutes
- 2GB {{ site.data.variables.product.prodname_registry }} storage
- Advanced tools and insights in private repositories:
- Required pull request reviewers
- Multiple pull request reviewers
- {{ site.data.variables.product.prodname_pages }}
- Wikis
- Protected branches
- Code owners
- Repository insights graphs: Pulse, contributors, traffic, commits, code frequency, network, and forks
- Draft pull requests
- Team pull request reviewers
- Scheduled reminders
{{ site.data.reusables.github-actions.actions-billing }}
### {{ site.data.variables.product.prodname_enterprise }}
{{ site.data.variables.product.prodname_enterprise }} includes two deployment options: cloud-hosted and self-hosted.
In addition to the features available with {{ site.data.variables.product.prodname_team }}, {{ site.data.variables.product.prodname_enterprise }} includes:
- {{ site.data.variables.contact.enterprise_support }}
- Additional security, compliance, and deployment controls
- Authentication with SAML single sign-on
- Access provisioning with SAML or SCIM
- {{ site.data.variables.product.prodname_github_connect }}
{{ site.data.variables.product.prodname_ghe_cloud }} also includes:
- {{ site.data.variables.contact.enterprise_support }}. For more information, see "<a href="/articles/github-enterprise-cloud-support" class="dotcom-only">{{ site.data.variables.product.prodname_ghe_cloud }} support</a>" and "<a href="/articles/github-enterprise-cloud-addendum" class="dotcom-only">{{ site.data.variables.product.prodname_ghe_cloud }} Addendum</a>."
- 50,000 {{ site.data.variables.product.prodname_actions }} minutes
- 50GB {{ site.data.variables.product.prodname_registry }} storage
- A service level agreement for 99.95% monthly uptime
- The option to centrally manage policy and billing for multiple {{ site.data.variables.product.prodname_dotcom_the_website }} organizations with an enterprise account. For more information, see "<a href="/articles/about-enterprise-accounts" class="dotcom-only">About enterprise accounts</a>."
You can set up a trial to evaluate {{ site.data.variables.product.prodname_ghe_cloud }}. For more information, see "[Setting up a trial of {{ site.data.variables.product.prodname_ghe_cloud }}](/articles/setting-up-a-trial-of-github-enterprise-cloud)."
For more information about hosting your own instance of [{{ site.data.variables.product.prodname_ghe_server }}](https://enterprise.github.com), contact {{ site.data.variables.contact.contact_enterprise_sales }}. {{ site.data.reusables.enterprise_installation.request-a-trial }}
### {{ site.data.variables.product.prodname_ghe_one }}
{{ site.data.variables.product.prodname_ghe_one }} includes [{{ site.data.variables.product.prodname_enterprise }}](#github-enterprise), plus:
- {{ site.data.variables.contact.github_support }} {{ site.data.variables.product.premium_plus_support_plan }}
- {{ site.data.variables.product.prodname_insights }}
- {{ site.data.variables.product.prodname_advanced_security }}
- [{{ site.data.variables.product.prodname_learning }} for organizations](https://lab.github.com/organizations)
For more information about signing up for {{ site.data.variables.product.prodname_ghe_one }}, contact [{{ site.data.variables.product.product_name }}'s Sales team](https://enterprise.github.com/contact).

View File

@@ -0,0 +1,62 @@
---
title: Getting started with GitHub
shortTitle: Getting started
intro: 'Learn about {{ site.data.variables.product.prodname_dotcom }}''s products, sign up for an account, and explore the {{ site.data.variables.product.prodname_dotcom }} community.'
redirect_from:
- /categories/54/articles/
- /categories/bootcamp/
- /categories/32/articles/
- /categories/2/articles/
- /categories/organizations/
- /categories/about-github/
- /categories/53/articles/
- /categories/setup/
- /categories/getting-started-with-github
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### Table of Contents
{% topic_link_in_list /quickstart %}
{% link_in_list /set-up-git %}
{% link_in_list /create-a-repo %}
{% link_in_list /fork-a-repo %}
{% link_in_list /be-social %}
{% topic_link_in_list /learning-about-github %}
<!-- if currentVersion == "free-pro-team@latest" -->
{% link_in_list /githubs-products %}
{% link_in_list /exploring-early-access-releases-with-feature-preview %}
<!-- endif -->
{% link_in_list /types-of-github-accounts %}
<!-- if currentVersion == "free-pro-team@latest" -->
{% link_in_list /faq-about-changes-to-githubs-plans %}
{% link_in_list /github-cli %}
{% link_in_list /github-desktop %}
{% link_in_list /github-for-mobile %}
<!-- endif -->
{% link_in_list /access-permissions-on-github %}
{% link_in_list /github-glossary %}
{% link_in_list /git-cheatsheet %}
{% link_in_list /git-and-github-learning-resources %}
{% topic_link_in_list /signing-up-for-github %}
<!-- if currentVersion == "free-pro-team@latest" -->
{% link_in_list /signing-up-for-a-new-github-account %}
{% link_in_list /verifying-your-email-address %}
<!-- endif -->
{% link_in_list /setting-up-a-trial-of-github-enterprise-cloud %}
{% link_in_list /setting-up-a-trial-of-github-enterprise-server %}
{% topic_link_in_list /exploring-projects-on-github %}
<!-- if currentVersion == "free-pro-team@latest" -->
{% link_in_list /finding-ways-to-contribute-to-open-source-on-github %}
<!-- endif -->
{% link_in_list /saving-repositories-with-stars %}
{% link_in_list /following-people %}
{% topic_link_in_list /using-github %}
{% link_in_list /supported-browsers %}
<!-- if currentVersion == "free-pro-team@latest" -->
{% link_in_list /troubleshooting-connectivity-problems %}
<!-- endif -->
{% link_in_list /keyboard-shortcuts %}

View File

@@ -0,0 +1,193 @@
---
title: Keyboard shortcuts
intro: 'Nearly every page on {{ site.data.variables.product.product_name }} has a keyboard shortcut to perform actions faster.'
redirect_from:
- /articles/using-keyboard-shortcuts/
- /categories/75/articles/
- /categories/keyboard-shortcuts/
- /articles/keyboard-shortcuts
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### About keyboard shortcuts
Typing <kbd>?</kbd> in {{ site.data.variables.product.product_name }} brings up a dialog box that lists the keyboard shortcuts available for that page. You can use these keyboard shortcuts to perform actions across the site without using your mouse to navigate.
Below is a list of some of the available keyboard shortcuts.
### Site wide shortcuts
| Keyboard shortcut | Description
|-----------|------------
|<kbd>s</kbd> or <kbd>/</kbd> | Focus the search bar. For more information, see "[About searching on {{ site.data.variables.product.company_short }}](/articles/about-searching-on-github)."
|<kbd>g</kbd> <kbd>n</kbd> | Go to your notifications. For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[About notifications](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}."
|<kbd>esc</kbd> | When focused on a user, issue, or pull request hovercard, closes the hovercard and refocuses on the element the hovercard is in
### Repositories
| Keyboard shortcut | Description
|-----------|------------
|<kbd>g</kbd> <kbd>c</kbd> | Go to the **Code** tab
|<kbd>g</kbd> <kbd>i</kbd> | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)."
|<kbd>g</kbd> <kbd>p</kbd> | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)."
|<kbd>g</kbd> <kbd>a</kbd> | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."
|<kbd>g</kbd> <kbd>b</kbd> | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)."
|<kbd>g</kbd> <kbd>w</kbd> | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)."
### Source code editing
| Keyboard shortcut | Description
|-----------|------------
|<kbd>e</kbd> | Open source code file in the **Edit file** tab
|<kbd>control f</kbd> or <kbd>command f</kbd> | Start searching in file editor
|<kbd>control g</kbd> or <kbd>command g</kbd> | Find next
|<kbd>shift control g</kbd> or <kbd>shift command g</kbd> | Find previous
|<kbd>shift control f</kbd> or <kbd>command option f</kbd> | Replace
|<kbd>shift control r</kbd> or <kbd>shift command option f</kbd> | Replace all
|<kbd>alt g</kbd> | Jump to line
|<kbd>control z</kbd> or <kbd>command z</kbd> | Undo
|<kbd>control y</kbd> or <kbd>command y</kbd> | Redo
|<kbd>cmd + shift + p</kbd> | Toggles between the **Edit file** and **Preview changes** tabs
For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirror.net/doc/manual.html#commands).
### Source code browsing
| Keyboard shortcut | Description
|-----------|------------
|<kbd>t</kbd> | Activates the file finder
|<kbd>l</kbd> | Jump to a line in your code
|<kbd>w</kbd> | Switch to a new branch or tag
|<kbd>y</kbd> | Expand a URL to its canonical form. For more information, see "[Getting permanent links to files](/articles/getting-permanent-links-to-files)."
|<kbd>i</kbd> | Show or hide comments on diffs. For more information, see "[Commenting on the diff of a pull request](/articles/commenting-on-the-diff-of-a-pull-request)."
|<kbd>b</kbd> | Open blame view. For more information, see "[Tracing changes in a file](/articles/tracing-changes-in-a-file)."
### Comments
| Keyboard shortcut | Description
|-----------|------------
| <kbd>control b</kbd> or <kbd>command b</kbd> | Inserts Markdown formatting for bolding text
| <kbd>control i</kbd> or <kbd>command i</kbd> | Inserts Markdown formatting for italicizing text
| <kbd>control k</kbd> or <kbd>command k</kbd> | Inserts Markdown formatting for creating a link
| <kbd>control shift p</kbd> or <kbd>command shift p</kbd>| Toggles between the **Write** and **Preview** comment tabs
| <kbd>control enter</kbd> | Submits a comment
| <kbd>control .</kbd> and then <kbd>control [saved reply number]</kbd> | Opens saved replies menu and then autofills comment field with a saved reply. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %}
|<kbd>control g</kbd> or <kbd>command g</kbd> | Insert a suggestion. For more information, see "[Reviewing proposed changes in a pull request](/articles/reviewing-proposed-changes-in-a-pull-request)." |{% endif %}
| <kbd>r</kbd> | Quote the selected text in your reply. For more information, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax#quoting-text)." |
### Issue and pull request lists
| Keyboard shortcut | Description
|-----------|------------
|<kbd>c</kbd> | Create an issue
| <kbd>control /</kbd> or <kbd>command /</kbd> | Focus your cursor on the issues or pull requests search bar. For more information, see "[Using search to filter issues and pull requests](/articles/using-search-to-filter-issues-and-pull-requests)."||
|<kbd>u</kbd> | Filter by author
|<kbd>l</kbd> | Filter by or edit labels. For more information, see "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)."
| <kbd>alt</kbd> and click | While filtering by labels, exclude labels. For more information, see "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)."
|<kbd>m</kbd> | Filter by or edit milestones. For more information, see "[Filtering issues and pull requests by milestone](/articles/filtering-issues-and-pull-requests-by-milestone)."
|<kbd>a</kbd> | Filter by or edit assignee. For more information, see "[Filtering issues and pull requests by assignees](/articles/filtering-issues-and-pull-requests-by-assignees)."
|<kbd>o</kbd> or <kbd>enter</kbd> | Open issue
### Issues and pull requests
| Keyboard shortcut | Description
|-----------|------------
|<kbd>q</kbd> | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)."
|<kbd>m</kbd> | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)."
|<kbd>l</kbd> | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)."
|<kbd>a</kbd> | Set an assignee. For more information, see "[Assigning issues and pull requests to other {{ site.data.variables.product.company_short }} users](/articles/assigning-issues-and-pull-requests-to-other-github-users/)."
|<kbd>cmd + shift + p</kbd> or <kbd>control + shift + p</kbd> | Toggles between the **Write** and **Preview** tabs
### Changes in pull requests
| Keyboard shortcut | Description
|-----------|------------
|<kbd>c</kbd> | Open the list of commits in the pull request
|<kbd>t</kbd> | Open the list of changed files in the pull request
|<kbd>j</kbd> | Move selection down in the list
|<kbd>k</kbd> | Move selection up in the list
| <kbd>cmd + shift + enter </kbd> | Add a single comment on a pull request diff |
| <kbd>alt</kbd> and click | Toggle between collapsing and expanding all outdated review comments in a pull request by holding down `alt` and clicking **Show outdated** or **Hide outdated**.|{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
| Click, then <kbd>shift</kbd> and click | Comment on multiple lines of a pull request by clicking a line number, holding <kbd>shift</kbd>, then clicking another line number. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."|{% endif %}
### Project boards
#### Moving a column
| Keyboard shortcut | Description
|-----------|------------
|<kbd>enter</kbd> or <kbd>space</kbd> | Start moving the focused column
|<kbd>escape</kbd> | Cancel the move in progress
|<kbd>enter</kbd> | Complete the move in progress
|<kbd>←</kbd> or <kbd>h</kbd> | Move column to the left
|<kbd>command ←</kbd> or <kbd>command h</kbd> or <kbd>control ←</kbd> or <kbd>control h</kbd> | Move column to the leftmost position
|<kbd>→</kbd> or <kbd>l</kbd> | Move column to the right
|<kbd>command →</kbd> or <kbd>command l</kbd> or <kbd>control →</kbd> or <kbd>control l</kbd> | Move column to the rightmost position
#### Moving a card
| Keyboard shortcut | Description
|-----------|------------
|<kbd>enter</kbd> or <kbd>space</kbd> | Start moving the focused card
|<kbd>escape</kbd> | Cancel the move in progress
|<kbd>enter</kbd> | Complete the move in progress
|<kbd>↓</kbd> or <kbd>j</kbd> | Move card down
|<kbd>command ↓</kbd> or <kbd>command j</kbd> or <kbd>control ↓</kbd> or <kbd>control j</kbd> | Move card to the bottom of the column
|<kbd>↑</kbd> or <kbd>k</kbd> | Move card up
|<kbd>command ↑</kbd> or <kbd>command k</kbd> or <kbd>control ↑</kbd> or <kbd>control k</kbd> | Move card to the top of the column
|<kbd>←</kbd> or <kbd>h</kbd> | Move card to the bottom of the column on the left
|<kbd>shift ←</kbd> or <kbd>shift h</kbd> | Move card to the top of the column on the left
|<kbd>command ←</kbd> or <kbd>command h</kbd> or <kbd>control ←</kbd> or <kbd>control h</kbd> | Move card to the bottom of the leftmost column
|<kbd>command shift ←</kbd> or <kbd>command shift h</kbd> or <kbd>control shift ←</kbd> or <kbd>control shift h</kbd> | Move card to the top of the leftmost column
|<kbd>→</kbd> | Move card to the bottom of the column on the right
|<kbd>shift →</kbd> or <kbd>shift l</kbd> | Move card to the top of the column on the right
|<kbd>command →</kbd> or <kbd>command l</kbd> or <kbd>control →</kbd> or <kbd>control l</kbd> | Move card to the bottom of the rightmost column
|<kbd>command shift →</kbd> or <kbd>command shift l</kbd> or <kbd>control shift →</kbd> or <kbd>control shift l</kbd> | Move card to the bottom of the rightmost column
#### Previewing a card
| Keyboard shortcut | Description
|-----------|------------
|<kbd>esc</kbd> | Close the card preview pane
{% if currentVersion == "free-pro-team@latest" %}
### {{ site.data.variables.product.prodname_actions }}
| Keyboard shortcut | Description
|-----------|------------
|<kbd>command space </kbd> or <kbd>control space</kbd> | In the workflow editor, get suggestions for your workflow file.
{% endif %}
### Notifications
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
| Keyboard shortcut | Description
|-----------|------------
|<kbd>e</kbd> | Mark as done
| <kbd>shift u</kbd>| Mark as unread
| <kbd>shift i</kbd>| Mark as read
| <kbd>shift m</kbd> | Unsubscribe
{% else %}
| Keyboard shortcut | Description
|-----------|------------
|<kbd>e</kbd> or <kbd>I</kbd> or <kbd>y</kbd> | Mark as read
|<kbd>shift m</kbd> | Mute thread
{% endif %}
### Network graph
| Keyboard shortcut | Description
|-----------|------------
|<kbd>←</kbd> or <kbd>h</kbd> | Scroll left
|<kbd>→</kbd> or <kbd>l</kbd> | Scroll right
|<kbd>↑</kbd> or <kbd>k</kbd> | Scroll up
|<kbd>↓</kbd> or <kbd>j</kbd> | Scroll down
|<kbd>shift ←</kbd> or <kbd>shift h</kbd> | Scroll all the way left
|<kbd>shift →</kbd> or <kbd>shift l</kbd> | Scroll all the way right
|<kbd>shift ↑</kbd> or <kbd>shift k</kbd> | Scroll all the way up
|<kbd>shift ↓</kbd> or <kbd>shift j</kbd> | Scroll all the way down

View File

@@ -0,0 +1,11 @@
---
title: Learning about GitHub
intro: ''
mapTopic: true
redirect_from:
- /articles/learning-about-github
versions:
free-pro-team: '*'
enterprise-server: '*'
---

View File

@@ -0,0 +1,9 @@
---
title: Quickstart
intro: 'Quickly get started with common tasks on {{ site.data.variables.product.prodname_dotcom }}.'
mapTopic: true
versions:
free-pro-team: '*'
enterprise-server: '*'
---

View File

@@ -0,0 +1,51 @@
---
title: Saving repositories with stars
intro: 'You can star repositories{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.16" %} and topics{% endif %} to keep track of projects you find interesting{% if currentVersion == "free-pro-team@latest" %} and discover related content in your news feed{% endif %}.'
redirect_from:
- /articles/stars/
- /articles/about-stars/
- /articles/browsing-friends-stars/
- /articles/managing-your-stars/
- /articles/saving-repositories-with-stars
versions:
free-pro-team: '*'
enterprise-server: '*'
---
You can search, sort, and filter your starred repositories and topics on your {{ site.data.variables.explore.your_stars_page }}.'
### About stars
Starring makes it easy to find a repository or topic again later. You can see all the repositories and topics you have starred by going to your {{ site.data.variables.explore.your_stars_page }}.
{% if currentVersion == "free-pro-team@latest" %}
You can star repositories and topics to discover similar projects on {{ site.data.variables.product.product_name }}. When you star repositories or topics, {{ site.data.variables.product.product_name }} may recommend related content in the discovery view of your news feed. For more information, see "[Finding ways to contribute to open source on {{ site.data.variables.product.prodname_dotcom }}](/github/getting-started-with-github/finding-ways-to-contribute-to-open-source-on-github)."
{% endif %}
Starring a repository also shows appreciation to the repository maintainer for their work. Many of {{ site.data.variables.product.prodname_dotcom }}'s repository rankings depend on the number of stars a repository has. In addition, [Explore](https://github.com/explore) shows popular repositories based on the number of stars they have.
### Searching stars
![Searching through stars](/assets/images/help/stars/stars_search_bar.png)
You can use the search bar to quickly find repositories and topics you've starred. The search bar only searches based on the name of a repository or topic, and not on any other qualifiers (such as the size of the repository or when it was last updated).
### Sorting and filtering stars
![Sorting stars](/assets/images/help/stars/stars_sort_menu.png)
In the upper-right corner of your stars page, you can sort your starred repositories and topics by recently starred, recently active, and most stars.
On the right side of the page, you can filter your list of starred repositories based on their language.
![Filter stars by language](/assets/images/help/stars/stars_filter_language.png)
### Browsing your friends' stars
In the lower-right corner of the page, you can also browse your friends' stars. You can use this to find new repositories and topics to star.
![Viewing your friends' stars](/assets/images/help/stars/stars_jump_to_a_friend.png)
### Further reading
- "[Classifying your repository with topics](/articles/classifying-your-repository-with-topics)"

View File

@@ -0,0 +1,56 @@
---
title: Set up Git
redirect_from:
- /git-installation-redirect/
- /linux-git-installation/
- /linux-set-up-git/
- /mac-git-installation/
- /mac-set-up-git/
- /set-up-git-redirect/
- /win-git-installation/
- /win-set-up-git/
- /articles/set-up-git
intro: 'At the heart of {{ site.data.variables.product.product_name }} is an open source version control system (VCS) called Git. Git is responsible for everything {{ site.data.variables.product.product_name }}-related that happens locally on your computer.'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
To use Git on the command line, you'll need to download, install, and configure Git on your computer. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} You can also install {{ site.data.variables.product.prodname_cli }} to use {{ site.data.variables.product.product_name }} from the command line. For more information on {{ site.data.variables.product.prodname_cli }}, see the [{{ site.data.variables.product.prodname_cli }}](https://cli.github.com/manual/) documentation.{% endif %}
If you want to work with Git locally, but don't want to use the command line, you can instead download and install the [{{ site.data.variables.product.prodname_desktop }}]({{ site.data.variables.product.desktop_link }}) client. For more information, see "[Installing and configuring {{ site.data.variables.product.prodname_desktop }}](/desktop/installing-and-configuring-github-desktop/)."
If you don't need to work with files locally, {{ site.data.variables.product.product_name }} lets you complete many Git-related actions directly in the browser, including:
- [Creating a repository](/articles/create-a-repo)
- [Forking a repository](/articles/fork-a-repo)
- [Managing files](/articles/managing-files-on-github/)
- [Being social](/articles/be-social)
### Setting up Git
1. [Download and install the latest version of Git](https://git-scm.com/downloads).
2. [Set your username in Git](/articles/setting-your-username-in-git).
3. [Set your commit email address in Git](/articles/setting-your-commit-email-address).
### Next steps: Authenticating with {{ site.data.variables.product.prodname_dotcom }} from Git
When you connect to a {{ site.data.variables.product.product_name }} repository from Git, you'll need to authenticate with {{ site.data.variables.product.product_name }} using either HTTPS or SSH.
#### Connecting over HTTPS (recommended)
If you [clone with HTTPS](/articles/which-remote-url-should-i-use/#cloning-with-https-urls), you can [cache your {{ site.data.variables.product.prodname_dotcom }} credentials in Git](/github/using-git/caching-your-github-credentials-in-git) using a credential helper.
#### Connecting over SSH
If you [clone with SSH](/articles/which-remote-url-should-i-use#cloning-with-ssh-urls), you must [generate SSH keys](/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) on each computer you use to push or pull from {{ site.data.variables.product.product_name }}.
### Celebrate
Congratulations, you now have Git and {{ site.data.variables.product.product_name }} all set up! What do you want to do next?
- **Set up Git**
- "[Create a repository](/articles/create-a-repo)"
- "[Fork a repository](/articles/fork-a-repo)"
- "[Be social](/articles/be-social)"
- {{ site.data.reusables.support.connect-in-the-forum-bootcamp }}

View File

@@ -0,0 +1,67 @@
---
title: Setting up a trial of GitHub Enterprise Cloud
intro: 'You can try {{ site.data.variables.product.prodname_ghe_cloud }} for free.'
redirect_from:
- /articles/setting-up-a-trial-of-github-enterprise-cloud
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### About trials of {{ site.data.variables.product.prodname_ghe_cloud }}
You can set up a 14-day trial to evaluate {{ site.data.variables.product.prodname_ghe_cloud }} on a new organization account. You do not need to provide a payment method during the trial unless you add {{ site.data.variables.product.prodname_marketplace }} apps to your organization that require a payment method. For more information, see "<a href="/articles/about-billing-for-github-marketplace/" class="dotcom-only">About billing for {{ site.data.variables.product.prodname_marketplace }}</a>."
Your trial includes 50 seats. If you need more seats to evaluate {{ site.data.variables.product.prodname_ghe_cloud }}, contact {{ site.data.variables.contact.contact_enterprise_sales }}. At the end of the trial, you can choose a different number of seats.
Trials are also available for {{ site.data.variables.product.prodname_ghe_server }}. For more information, see "[Setting up a trial of {{ site.data.variables.product.prodname_ghe_server }}](/articles/setting-up-a-trial-of-github-enterprise-server)."
{{ site.data.reusables.products.which-product-to-use }}
### Setting up your trial of {{ site.data.variables.product.prodname_ghe_cloud }}
Before you can start your trial of {{ site.data.variables.product.prodname_ghe_cloud }}, you must have an existing user account or create a new user account. For more information, see "<a href="/articles/signing-up-for-a-new-github-account" class="dotcom-only">Signing up for a new {{ site.data.variables.product.prodname_dotcom }} account</a>."
{{ site.data.reusables.user_settings.access_settings }}
{{ site.data.reusables.user_settings.organizations }}
{{ site.data.reusables.organizations.new-organization }}
4. Under "Enterprise", click **Start your 14-day free trial**.
![Button to start your trial](/assets/images/help/organizations/start-trial-button.png)
5. Type your company name.
![Company name field](/assets/images/help/organizations/company-name-field.png)
{{ site.data.reusables.organizations.organization-name }}
7. Under "Full name", type your full name.
![Full name field](/assets/images/help/organizations/full-name-field.png)
8. Under "Work email", type the email address you use for work.
![Work email field](/assets/images/help/organizations/work-email-field.png)
8. Use the **Industry** drop-down menu, and select the industry your company is in.
![Industry drop-down menu](/assets/images/help/organizations/industry-drop-down.png)
9. Use the **Number of employees** drop-down menu, and select the number of employees at your company.
![Number of employees drop-down menu](/assets/images/help/organizations/employees-drop-down.png)
10. Review the <a href="/articles/github-enterprise-cloud-evaluation-agreement" class="dotcom-only">Evaluation License Agreement</a>, then click **Next**.
### Exploring {{ site.data.variables.product.prodname_ghe_cloud }}
After setting up your trial, you can explore {{ site.data.variables.product.prodname_ghe_cloud }} by following the [Enterprise Onboarding Guide](https://resources.github.com/enterprise-onboarding/).
{{ site.data.reusables.products.product-roadmap }}
### Finishing your trial
You can buy {{ site.data.variables.product.prodname_enterprise }} or downgrade to {{ site.data.variables.product.prodname_team }} at any time during your trial.
If you don't purchase {{ site.data.variables.product.prodname_enterprise }} or {{ site.data.variables.product.prodname_team }} before your trial ends, your organization will be downgraded to {{ site.data.variables.product.prodname_free_team }} and lose access to any advanced tooling and features that are only included with paid products, including {{ site.data.variables.product.prodname_pages }} sites published from those private repositories. If you don't plan to upgrade, to avoid losing access to advanced features, make the repositories public before your trial ends. For more information, see "[Setting repository visibility](/articles/setting-repository-visibility)."
Downgrading to {{ site.data.variables.product.prodname_free_team }} for organizations also disables any SAML settings configured during the trial period. Once you purchase {{ site.data.variables.product.prodname_enterprise }} or {{ site.data.variables.product.prodname_team }}, your SAML settings will be enabled again for users in your organization to authenticate.
{{ site.data.reusables.profile.access_profile }}
{{ site.data.reusables.profile.access_org }}
{{ site.data.reusables.organizations.org_settings }}
{{ site.data.reusables.organizations.billing }}
5. Under "{{ site.data.variables.product.prodname_ghe_cloud }} Free Trial", click **Buy Enterprise** or **Downgrade to Team**.
![Buy Enterprise and Downgrade to Team buttons](/assets/images/help/organizations/finish-trial-buttons.png)
6. Follow the prompts to enter your payment method, then click **Submit**.
### Further reading
- "[Setting up a trial of {{ site.data.variables.product.prodname_ghe_server }}](/articles/setting-up-a-trial-of-github-enterprise-server)"

View File

@@ -0,0 +1,61 @@
---
title: Setting up a trial of GitHub Enterprise Server
intro: 'You can try {{ site.data.variables.product.prodname_ghe_server }} for free.'
redirect_from:
- /articles/requesting-a-trial-of-github-enterprise/
- /articles/setting-up-a-trial-of-github-enterprise-server
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### About trials of {{ site.data.variables.product.prodname_ghe_server }}
You can request a 45-day trial to evaluate {{ site.data.variables.product.prodname_ghe_server }}. Your trial will be installed as a virtual appliance, with options for on-premises or cloud deployment. For a list of supported visualization platforms, see "[Setting up a GitHub Enterprise Server instance](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)."
{% if currentVersion ver_gt "enterprise-server@2.21" %}{{ site.data.variables.product.prodname_dependabot_short }}{% else %}Security{% endif %} alerts and {{ site.data.variables.product.prodname_github_connect }} are not currently available in trials of {{ site.data.variables.product.prodname_ghe_server }}. For a demonstration of these features, contact {{ site.data.variables.contact.contact_enterprise_sales }}. For more information about these features, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" and "[Connecting {{ site.data.variables.product.prodname_ghe_server }} to {{ site.data.variables.product.prodname_dotcom_the_website }}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)."
Trials are also available for {{ site.data.variables.product.prodname_ghe_cloud }}. For more information, see "[Setting up a trial of {{ site.data.variables.product.prodname_ghe_cloud }}](/articles/setting-up-a-trial-of-github-enterprise-cloud)."
{{ site.data.reusables.products.which-product-to-use }}
### Setting up your trial of {{ site.data.variables.product.prodname_ghe_server }}
{{ site.data.variables.product.prodname_ghe_server }} is installed as a virtual appliance. Determine the best person in your organization to set up a virtual machine, and ask that person to submit a [trial request](https://enterprise.github.com/trial). You can begin your trial immediately after submitting a request.
To set up an account for the {{ site.data.variables.product.prodname_enterprise }} Web portal, click the link in the email you received after submitting your trial request, and follow the prompts. Then, download your license file. For more information, see "[Managing your {{ site.data.variables.product.prodname_enterprise }} license](/enterprise/admin/installation/managing-your-github-enterprise-license)."
To install {{ site.data.variables.product.prodname_ghe_server }}, download the necessary components and upload your license file. For more information, see the instructions for your chosen visualization platform in "[Setting up a {{ site.data.variables.product.prodname_ghe_server }} instance](/enterprise/admin/installation/setting-up-a-github-enterprise-server-instance)."
### Next steps
To get the most out of your trial, follow these steps:
1. [Create an organization](/enterprise/admin/user-management/creating-organizations).
2. To learn the basics of using {{ site.data.variables.product.prodname_dotcom }}, see:
- [Quick start guide to {{ site.data.variables.product.prodname_dotcom }}](https://resources.github.com/webcasts/Quick-start-guide-to-GitHub/) webcast
- [Understanding the {{ site.data.variables.product.prodname_dotcom }} flow](https://guides.github.com/introduction/flow/) in {{ site.data.variables.product.prodname_dotcom }} Guides
- [Hello World](https://guides.github.com/activities/hello-world/) in {{ site.data.variables.product.prodname_dotcom }} Guides
3. To configure your instance to meet your organization's needs, see "[Configuring the {{ site.data.variables.product.prodname_ghe_server }} appliance](/enterprise/admin/installation/configuring-the-github-enterprise-server-appliance)."
4. To integrate {{ site.data.variables.product.prodname_ghe_server }} with your identity provider, see "[Using SAML](/enterprise/admin/user-management/using-saml)" and "[Using LDAP](/enterprise/admin/authentication/using-ldap)."
5. Invite an unlimited number of people to join your trial.
- Add users to your {{ site.data.variables.product.prodname_ghe_server }} instance using built-in authentication or your configured identity provider. For more information, see "[Using built in authentication](/enterprise/admin/user-management/using-built-in-authentication)."
- To invite people to become account administrators, visit the [{{ site.data.variables.product.prodname_enterprise }} Web portal](https://enterprise.github.com/login).
{% note %}
**Note:** People you invite to become account administrators will receive an email with a link to accept your invitation.
{% endnote %}
{{ site.data.reusables.products.product-roadmap }}
### Finishing your trial
You can upgrade to full licenses in the [{{ site.data.variables.product.prodname_enterprise }} Web portal](https://enterprise.github.com/login) at any time during the trial period.
If you haven't upgraded by the last day of your trial, you'll receive an email notifying you that your trial had ended. If you need more time to evaluate {{ site.data.variables.product.prodname_enterprise }}, contact {{ site.data.variables.contact.contact_enterprise_sales }} to request an extension.
### Further reading
- "[Setting up a trial of {{ site.data.variables.product.prodname_ghe_cloud }}](/articles/setting-up-a-trial-of-github-enterprise-cloud)"

View File

@@ -0,0 +1,22 @@
---
title: Signing up for a new GitHub account
intro: '{{ site.data.variables.product.product_name }} offers user accounts for individuals and organizations for teams of people working together.'
redirect_from:
- /articles/signing-up-for-a-new-github-account
versions:
free-pro-team: '*'
---
For more information about account types and products, see "[Types of {{ site.data.variables.product.prodname_dotcom }} accounts](/articles/types-of-github-accounts)" and "[{{ site.data.variables.product.product_name }}'s products](/articles/github-s-products)."
1. Go to {{ site.data.variables.product.product_name }}'s [Pricing]({{ site.data.variables.product.pricing_url }}) page.
2. Read the information about the different products and subscriptions that {{ site.data.variables.product.product_name }} offers, then click the upgrade button under the subscription you'd like to choose.
3. Follow the prompts to create your personal account or organization.
### Next steps
- "[Verify your email address](/articles/verifying-your-email-address)"
- "[Configure two-factor authentication](/articles/configuring-two-factor-authentication)"
- "[Add a bio to your profile](/articles/adding-a-bio-to-your-profile)"
- "[Create an organization](/articles/creating-a-new-organization-from-scratch)"
- [ {{ site.data.variables.product.prodname_roadmap }} ]( {{ site.data.variables.product.prodname_roadmap_link }} ) in the `github/roadmap` repository

View File

@@ -0,0 +1,11 @@
---
title: Signing up for GitHub
intro: ''
mapTopic: true
redirect_from:
- /articles/signing-up-for-github
versions:
free-pro-team: '*'
enterprise-server: '*'
---

View File

@@ -0,0 +1,19 @@
---
title: Supported browsers
redirect_from:
- /articles/why-doesn-t-graphs-work-with-ie-8/
- /articles/why-don-t-graphs-work-with-ie8/
- /articles/supported-browsers
intro: 'We design {{ site.data.variables.product.product_name }} to support the latest web browsers. We support the current versions of [Chrome](https://www.google.com/chrome/), [Firefox](http://www.mozilla.org/firefox/), [Safari](http://www.apple.com/safari/), {% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.16" %}Internet Explorer 11, {% endif %}and [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge).'
versions:
free-pro-team: '*'
enterprise-server: '*'
---
### Firefox Extended Support Release
We do our best to support Firefox's latest [Extended Support Release](https://www.mozilla.org/en-US/firefox/organizations/) (ESR). Older versions of Firefox may disable some features on {{ site.data.variables.product.product_name }} and require the latest version of Firefox.
### Beta and developer builds
You may encounter unexpected bugs in beta and developer builds of our supported browsers. If you encounter a bug on {{ site.data.variables.product.product_name }} in one of these unreleased builds, please verify that it also exists in the stable version of the same browser. If the bug only exists in the unstable version, consider reporting the bug to the browser developer.

View File

@@ -0,0 +1,43 @@
---
title: Troubleshooting connectivity problems
intro: 'If you''re having trouble connecting to {{ site.data.variables.product.prodname_dotcom }}, you can troubleshoot your connection, then use the {{ site.data.variables.product.prodname_debug }} tool to diagnose problems.'
redirect_from:
- /articles/troubleshooting-connectivity-problems
versions:
free-pro-team: '*'
---
Most often, connection problems occur because a firewall, proxy server, corporate network, or other network is configured in a way that blocks {{ site.data.variables.product.prodname_dotcom }}.
### Allowing {{ site.data.variables.product.prodname_dotcom }}'s IP addresses
Make sure your network is configured to allow {{ site.data.variables.product.prodname_dotcom }}'s IP addresses. For more information, see "[About {{ site.data.variables.product.prodname_dotcom }}'s IP addresses](/articles/about-github-s-ip-addresses)."
### Using a company or organization's network
If you're having connectivity problems on your company or organization's network, check with your network administrator to find out if the network has rules in place to block certain traffic. If there are rules in place, ask your network administrator to allow traffic to {{ site.data.variables.product.prodname_dotcom }}.
### Troubleshooting the captcha
If you're unable to verify with the captcha:
- Ensure javascript is enabled on your browser.
- Ensure your browser is supported. If your browser isn't supported, upgrade your browser or install a supported browser. For a list of supported browsers, see "[Supported browsers](/articles/supported-browsers)."
- Ensure your network configuration is not blocking https://octocaptcha.com/ or https://arkoselabs.com/. If you're behind a corporate firewall, contact your IT administrator to allow those domains. To verify access to these domains, visit https://octocaptcha.com/test and ensure the text "Connection successfully made!" is displayed, then visit https://client-demo.arkoselabs.com/github and ensure you are able to load the captcha.
- Ensure your browser does not have plug-ins or extensions that may be interfering with GitHub. If so, temporarily disable the plug-ins or extensions during captcha verification.
### Switching cloning methods
Switching from cloning via SSH to cloning via HTTPS, or vice versa may improve connectivity. For more information, see "[Cloning a repository from {{ site.data.variables.product.prodname_dotcom }}](/articles/cloning-a-repository-from-github)."
If you're encountering timeouts with SSH, see "[Error: Bad file number](/articles/error-bad-file-number)."
### Troubleshooting slow downloads and intermittent slow connections
{{ site.data.variables.product.prodname_dotcom }} does not throttle bandwidth per user.
If you're experiencing slow connections at certain times of day but not others, the slow speeds are most likely due to network congestion. Because {{ site.data.variables.product.prodname_dotcom }} cannot resolve network congestion, you should escalate the problem to your internet service provider.
### Troubleshooting with {{ site.data.variables.product.prodname_debug }}
If you've followed all of the troubleshooting suggestions above and are still having connection problems, you can follow the instructions on the {{ site.data.variables.product.prodname_debug }} site to run tests and send a report to {{ site.data.variables.product.prodname_dotcom }} Support. For more information, see [{{ site.data.variables.product.prodname_debug }}](https://github-debug.com/).

View File

@@ -0,0 +1,76 @@
---
title: Types of GitHub accounts
intro: 'Your user account is your identity on {{ site.data.variables.product.product_location }}. Your user account can be a member of any number of organizations.{% if currentVersion == "free-pro-team@latest" %} Organizations can belong to enterprise accounts.{% endif %}'
redirect_from:
- /manage-multiple-clients/
- /managing-clients/
- /articles/what-s-the-difference-between-user-and-organization-accounts/
- /articles/differences-between-user-and-organization-accounts/
- /articles/types-of-github-accounts
versions:
free-pro-team: '*'
enterprise-server: '*'
---
{% if currentVersion == "free-pro-team@latest" %}
For a full list of features for each {{ site.data.variables.product.product_name }} product, see "[{{ site.data.variables.product.prodname_dotcom }}'s products](/github/getting-started-with-github/githubs-products)."
{% endif %}
### Personal user accounts
Every person who uses {{ site.data.variables.product.product_location }} has their own user account, which includes:
{% if currentVersion == "free-pro-team@latest" %}
- Unlimited public and private repositories with {{ site.data.variables.product.prodname_free_user }}
- Unlimited collaborators with {{ site.data.variables.product.prodname_free_user }}
- Additional features for private repositories with {{ site.data.variables.product.prodname_pro }}
- Ability to [invite repository collaborators](/articles/inviting-collaborators-to-a-personal-repository)
{% else %}
- Unlimited repositories and [collaborators](/articles/permission-levels-for-a-user-account-repository)
- Ability to [add unlimited repository collaborators](/articles/inviting-collaborators-to-a-personal-repository)
{% endif %}
{% if currentVersion == "free-pro-team@latest" %}
{% tip %}
**Tips**:
- You can use one account for multiple purposes, such as for personal use and business use. We do not recommend creating more than one account. For more information, see "[Merging multiple user accounts](/articles/merging-multiple-user-accounts)."
- User accounts are intended for humans, but you can give one to a robot, such as a continuous integration bot, if necessary.
{% endtip %}
{% else %}
{% tip %}
**Tip**: User accounts are intended for humans, but you can give one to a robot, such as a continuous integration bot, if necessary.
{% endtip %}
{% endif %}
### Organization accounts
Organizations are shared accounts where groups of people can collaborate across many projects at once. Owners and administrators can manage member access to the organization's data and projects with sophisticated security and administrative features.
{{ site.data.reusables.organizations.organizations_include }}
{% if currentVersion == "free-pro-team@latest" %}
### Enterprise accounts
With enterprise accounts, you can centrally manage policy and billing for multiple {{ site.data.variables.product.prodname_dotcom_the_website }} organizations. {{ site.data.reusables.gated-features.enterprise-accounts }}
{% endif %}
### Further reading
{% if currentVersion == "free-pro-team@latest" %}- "[Signing up for a new {{ site.data.variables.product.prodname_dotcom }} account](/articles/signing-up-for-a-new-github-account)"
- "[{{ site.data.variables.product.prodname_dotcom }}'s products](/articles/githubs-products)"{% endif %}
- "[Creating a new organization account](/articles/creating-a-new-organization-account)"

View File

@@ -0,0 +1,11 @@
---
title: Using GitHub
intro: ''
mapTopic: true
redirect_from:
- /articles/using-github
versions:
free-pro-team: '*'
enterprise-server: '*'
---

View File

@@ -0,0 +1,66 @@
---
title: Verifying your email address
intro: 'Verifying your primary email address ensures strengthened security, allows {{ site.data.variables.product.prodname_dotcom }} staff to better assist you if you forget your password, and gives you access to more features on {{ site.data.variables.product.prodname_dotcom }}.'
redirect_from:
- /articles/troubleshooting-email-verification/
- /articles/setting-up-email-verification/
- /articles/verifying-your-email-address
versions:
free-pro-team: '*'
---
### About email verification
You can verify your email address after signing up for a new account, or when you add a new email address. If an email address is undeliverable or bouncing, it will be unverified.
If you do not verify your email address, you will not be able to:
- Create or fork repositories
- Create issues or pull requests
- Comment on issues, pull requests, or commits
- Authorize {{ site.data.variables.product.prodname_oauth_app }} applications
- Generate personal access tokens
- Receive email notifications
- Star repositories
- Create or update project boards, including adding cards
- Create or update gists
- Create or use {{ site.data.variables.product.prodname_actions }}
- Sponsor developers with {{ site.data.variables.product.prodname_sponsors }}
{% warning %}
**Warnings**:
- {{ site.data.reusables.user_settings.no-verification-disposable-emails }}
- {{ site.data.reusables.user_settings.verify-org-approved-email-domain }}
{% endwarning %}
### Verifying your email address
{{ site.data.reusables.user_settings.access_settings }}
{{ site.data.reusables.user_settings.emails }}
1. Under your email address, click **Resend verification email**.
![Resend verification email link](/assets/images/help/settings/email-verify-button.png)
4. {{ site.data.variables.product.prodname_dotcom }} will send you an email with a link in it. After you click that link, you'll be taken to your {{ site.data.variables.product.prodname_dotcom }} dashboard and see a confirmation banner.
![Banner confirming that your email was verified](/assets/images/help/settings/email-verification-confirmation-banner.png)
### Troubleshooting email verification
#### Unable to send verification email
{{ site.data.reusables.user_settings.no-verification-disposable-emails }}
#### Error page after clicking verification link
The verification link expires after 24 hours. If you don't verify your email within 24 hours, you can request another email verification link. For more information, see "[Verifying your email address](/articles/verifying-your-email-address)."
If you click on the link in the confirmation email within 24 hours and you are directed to an error page, you should ensure that you're signed into the correct {{ site.data.variables.product.prodname_dotcom }} account.
1. {{ site.data.variables.product.signout_link }} of your personal {{ site.data.variables.product.prodname_dotcom }} account.
2. Quit and restart your browser.
3. {{ site.data.variables.product.signin_link }} to your personal {{ site.data.variables.product.prodname_dotcom }} account.
4. Click on the verification link in the email we sent you.
### Further reading
- "[Changing your primary email address](/articles/changing-your-primary-email-address)"