Skip to content

Commit 69334ec

Browse files
authored
Merge pull request #36815 from github/repo-sync
Repo sync
2 parents 2105dfc + 51323ed commit 69334ec

File tree

11 files changed

+250
-2
lines changed

11 files changed

+250
-2
lines changed

.github/workflows/moda-ci.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ jobs:
6767
ci-formatted-job-name: ${{ matrix.ci_job.job }}
6868
vault-keys: ${{ needs.set-vault-keys.outputs.modified_vault_keys }}
6969
# Passes 'DOCS_BOT_PAT_READPUBLICKEY' secret from Vault to docker as --secret id=DOCS_BOT_PAT_READPUBLICKEY,src=<PAT value>
70+
attest: true
7071
docker-build-env-secrets: 'DOCS_BOT_PAT_READPUBLICKEY'
7172
secrets:
7273
dx-bot-token: ${{ secrets.INTERNAL_ACTIONS_DX_BOT_ACCOUNT_TOKEN }}
@@ -99,3 +100,4 @@ permissions:
99100
contents: read
100101
statuses: read
101102
id-token: write
103+
attestations: write

.github/workflows/purge-fastly.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ on:
1616
languages:
1717
description: "Comma separated languages. E.g. 'en,ja, es' (defaults to all)"
1818
required: false
19-
default: ''
19+
default: 'en' # Temporary, only purge English on deploy. Set to empty string for all
2020

2121
permissions:
2222
contents: read

content/admin/managing-iam/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,10 @@ If users are experiencing errors when attempting to authenticate with SAML, see
6262

6363
{% ifversion ghec %}
6464

65+
## Conflicting SAML identity errors
66+
67+
{% data reusables.saml.conflicting-identity %}
68+
6569
## Further reading
6670

6771
* [AUTOTITLE](/admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/troubleshooting-team-membership-with-identity-provider-groups)
Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
---
2+
title: Getting started with Git
3+
intro: 'Learn the basics of Git by working through an example scenario.'
4+
topics:
5+
- Copilot
6+
- Git
7+
- Desktop
8+
versions:
9+
fpt: '*'
10+
shortTitle: Get started with Git
11+
---
12+
13+
Have you ever wished you had a time machine for your code? Well, Git is exactly that, and so much more!
14+
15+
If you aren't familiar with Git, it's a **version control** system that helps you keep track of changes to your code. You can save a snapshot of your project at a particular point in time, then make experimental changes without risking your work, since you can always go back to your snapshot.
16+
17+
{% data variables.product.github %} itself is a platform built around Git, letting you save your Git projects to the cloud and work on them with other developers.
18+
19+
While Git can be complicated, it's a powerful and necessary tool for any developer. This article will give you all the tools you need to use Git in your day-to-day workflow.
20+
21+
## Prerequisites
22+
23+
To follow this tutorial, you need to [install {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/download).
24+
25+
## Learning Git basics with {% data variables.product.prodname_desktop %}
26+
27+
For standard Git operations, we recommend {% data variables.product.prodname_desktop %}, an app that lets you interact with Git visually instead of through written commands. In this section, we'll learn how to use {% data variables.product.prodname_desktop %} to quickly perform the most common Git operations.
28+
29+
### Setting up {% data variables.product.prodname_desktop %}
30+
31+
If this is your first time using {% data variables.product.prodname_desktop %}, you need to install it and connect your {% data variables.product.github %} account.
32+
33+
1. [Download {% data variables.product.prodname_desktop %}](https://desktop.github.com/download/).
34+
1. Open {% data variables.product.prodname_desktop %}, then click **Sign in to {% data variables.product.prodname_dotcom_the_website %}** and authorize {% data variables.product.prodname_desktop %} to access your account.
35+
1. Back in {% data variables.product.prodname_desktop %}, click **Finish**. This will add your name and email from your {% data variables.product.github %} account to Git.
36+
37+
### Creating a local repository
38+
39+
Now, you can take your first steps into Git by creating a **repository**. Think of a repository as a project folder that tracks changes and stores history. First, we'll create a **local** repository:
40+
41+
1. In {% data variables.product.prodname_desktop %}, click **Create a New Repository on your Local Drive**.
42+
1. Name the repository `learning-git`.
43+
1. Select **Initialize this repository with a README** to create a blank `README.md` file automatically.
44+
45+
> [!TIP] It's standard practice to include a `README.md` file, also known as a README, in your projects. READMEs typically contain information that helps others understand, set up, and run your project.
46+
1. Click **Create repository**.
47+
48+
### Creating a remote repository
49+
50+
The local repository you just created lives on your computer. Now, let's create a **remote** repository for the same project, which will be hosted on {% data variables.product.github %}. Linking a remote repository makes it easier to collaborate on and back up your work.
51+
52+
1. In {% data variables.product.prodname_desktop %}, click **Publish repository**.
53+
1. In the pop up that appears, click **Publish repository** one more time.
54+
1. To see your remote repository, click **View on {% data variables.product.github %}**.
55+
56+
### Setting up a space to make changes
57+
58+
Now that you've created a repository, let's talk about **branches**. Branches are essentially copies of your project where you can test changes without risking the stability of your existing work.
59+
60+
Repositories are automatically created with a `main` branch, which you can think of as the stable, primary version of your project. For example, in the repository for a website, the `main` branch corresponds to the site that visitors can see.
61+
62+
When you create a new branch, you're creating a safe space to work on a new feature without affecting the primary version. You and your collaborators can use different branches to work on multiple features at the same time.
63+
64+
Let's create a branch to work on changes in our repository:
65+
66+
1. In {% data variables.product.prodname_desktop %}, select the {% octicon "git-branch" aria-hidden="true" %} **Current Branch** dropdown menu, then click **New Branch**.
67+
1. Name your new branch `readme-updates`, then click **Create Branch**.
68+
69+
### Saving snapshots of your project
70+
71+
To save your progress to your branch, you make a **commit**. A commit is a snapshot you take of your project at a particular point in time. You've actually already made your first commit: when you initialized your project with a README, {% data variables.product.prodname_desktop %} automatically created an initial commit to add the `README.md` file.
72+
73+
Whenever you complete a chunk of work that you want to save, you should make a commit. After you do, you can always go back to that point in time, no matter how many changes you make in the future.
74+
75+
1. In {% data variables.product.prodname_desktop %}, click **Open in {% data variables.product.prodname_vscode %}**.
76+
1. In {% data variables.product.prodname_vscode_shortname %}, paste the following text into `README.md` and save your changes:
77+
78+
```markdown copy
79+
Hello, World!
80+
81+
This is a demo project for learning how to use Git.
82+
```
83+
84+
1. Back in {% data variables.product.prodname_desktop %}, you'll see the updates you just made to your README. In the bottom left, next to your {% data variables.product.github %} profile picture, type "Update README" in the text box. This is called a **commit message**, and it helps you keep track of the changes you make in each commit.
85+
1. To make your commit, click **Commit to readme-updates**.
86+
87+
### Bringing your changes into your main branch
88+
89+
When you're happy with the changes you've made on a branch, you can publish your branch to the remote repository and create a **pull request**. Pull requests let you review a set of proposed changes, then merge them from one branch into another. In our case, we'll create a pull request that brings the changes we made in `readme-updates` into our original branch, `main`.
90+
91+
1. Click **Publish branch** to push the `readme-updates` branch with your changes to the remote repository.
92+
1. To review your suggested changes, click **Preview Pull Request**.
93+
1. Click **Create Pull Request**.
94+
1. In the {% data variables.product.github %} window that appears, change your pull request title to "Add a message to the README", then write a brief description of your changes in the comment box.
95+
1. Click **Create pull request**.
96+
1. To bring your changes into the `main` branch, at the bottom of the page, click **Merge pull request**.
97+
98+
> [!NOTE] When you're working on a project with other developers, it's standard practice for someone else to review your pull request before it's merged.
99+
100+
1. Near the bottom of the page, click **Delete branch**. Deleting branches that have been merged into `main` helps keep your repository clean and easy to navigate.
101+
102+
### Preparing to make more changes
103+
104+
Congratulations on merging your first pull request! Now that you've successfully brought your changes into the `main` branch, there are a few steps you should take to get ready for your next round of changes:
105+
106+
1. In {% data variables.product.prodname_desktop %}, if you aren't on the `main` branch, select the {% octicon "git-branch" aria-hidden="true" %} **Current Branch** dropdown menu, then click **main**.
107+
108+
You should almost always switch back to the `main` branch before creating a new branch, since new branches are created as copies of the currently selected branch.
109+
1. To check if any changes have been made to your remote `main` branch, click **Fetch origin**.
110+
1. Finally, to update your local `main` branch with changes to the remote `main` branch, click **Pull origin**.
111+
112+
You now have all of the skills necessary for setting up and using Git on a project!
113+
114+
## Diving deeper into Git on the command line
115+
116+
{% data variables.product.prodname_desktop %} is designed to address your day-to-day Git needs. As you grow as a developer, you're likely to run into some unusual situations where you want more control over a Git operation, or you need to use more complex commands. In those instances, you'll need to switch to using written Git commands on the command line.
117+
118+
### Setting up your command line
119+
120+
Before you start working with the command line, you need to set up a few tools.
121+
122+
1. In {% data variables.product.prodname_desktop %}, press <kbd>Ctrl</kbd>+<kbd>`</kbd> to open your project on the command line.
123+
1. If you're using Windows, [install Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). For macOS and Linux, Git is installed by default.
124+
1. [Install the {% data variables.product.prodname_cli %}](https://github.com/cli/cli?tab=readme-ov-file#installation), which lets you perform {% data variables.product.github %}-related actions quickly from the command line.
125+
1. To authenticate to {% data variables.product.github %} from the {% data variables.product.prodname_cli %}, run the following command:
126+
127+
```shell copy
128+
gh auth login
129+
```
130+
131+
Choose to authenticate with **{% data variables.product.prodname_dotcom_the_website %}**, then follow the on-screen prompts.
132+
1. Install {% data variables.product.prodname_copilot_cli %}, a powerful extension for the {% data variables.product.prodname_cli %} that helps you find and understand commands, by running the following command:
133+
134+
```shell copy
135+
gh extension install github/gh-copilot
136+
```
137+
138+
### Experimenting with complex commands
139+
140+
Now that you're set up, let's learn how to find and understand the commands you might need in the future. For example, let's say you saw someone online mention `git blame`, but you don't know what it does. Try asking {% data variables.product.prodname_copilot_short %} to explain it with the following command:
141+
142+
```shell copy
143+
gh copilot explain "git blame"
144+
```
145+
146+
{% data variables.product.prodname_copilot_short %} will tell us that `git blame` provides a detailed history of a file, showing the author and commit that last modified each line in the file. Try it yourself with the following command:
147+
148+
```shell copy
149+
git blame README.md
150+
```
151+
152+
This is a great tool, but as you can imagine, the blame for a file can get really long. Let's say you're only interested in the most recent update to a specific line in a file. You can ask {% data variables.product.prodname_copilot_short %} to build you the right command:
153+
154+
```shell copy
155+
gh copilot suggest "Show me the blame for line 1 of README.md"
156+
```
157+
158+
When {% data variables.product.prodname_copilot_short %} asks what kind of command you're looking for, use your arrow keys to choose **git command**, then press <kbd>Enter</kbd>. {% data variables.product.prodname_copilot_short %} will then suggest the following command:
159+
160+
```shell copy
161+
git blame -L 1,1 README.md
162+
```
163+
164+
Use your arrow keys to choose **Execute command**, then press <kbd>Enter</kbd>. You'll see the author and commit that last modified line 1 of `README.md`.
165+
166+
## Review and next steps
167+
168+
In this article, we covered the basics of Git with {% data variables.product.prodname_desktop %}, learning important terms like:
169+
170+
* **Repository**: A folder that saves all of the changes made to files in your project.
171+
* **Commit**: A snapshot of your project at a particular point in time.
172+
* **Branch**: A copy of your project where you can work on a set of changes.
173+
* **Pull request**: A request to merge changes from one branch into another.
174+
175+
We also talked about performing more complicated Git operations on the command line. We tried out `gh copilot explain` and `gh copilot suggest` to understand and find new commands and functionality.
176+
177+
Now, try applying what you've learned to your own work. Add Git to an existing project with {% data variables.product.prodname_desktop %} by pressing <kbd>Ctrl</kbd>+<kbd>O</kbd> (Windows/Linux) or <kbd>Command</kbd>+<kbd>O</kbd> (Mac) and experience the benefits of version control yourself!

content/get-started/learning-to-code/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ intro: "Learn how {% data variables.product.github %} can help while you're lear
44
versions:
55
fpt: '*'
66
children:
7+
- /getting-started-with-git
78
- /finding-and-understanding-example-code
89
- /reusing-other-peoples-code-in-your-projects
910
- /learning-to-debug-with-github-copilot

content/get-started/start-your-journey/about-github-and-git.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,11 @@ Typically, to do this in a Git-based workflow, you would:
3939
* Let Git intelligently **merge** your specific changes back into the main copy of files, so that your changes don't impact other people's updates.
4040
* Let Git **keep track** of your and other people's changes, so you all stay working on the most up-to-date version of the project.
4141

42+
{% ifversion fpt %}
43+
To try using Git yourself, see [AUTOTITLE](/get-started/learning-to-code/getting-started-with-git).
44+
{% else %}
4245
If you want to learn more about Git, see [AUTOTITLE](/get-started/using-git/about-git).
46+
{% endif %}
4347

4448
### How do Git and {% data variables.product.github %} work together?
4549

content/organizations/managing-saml-single-sign-on-for-your-organization/troubleshooting-identity-and-access-management-for-your-organization.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,10 @@ To confirm that a user's SCIM identity is created, we recommend testing this pro
9696

9797
If re-provisioning SCIM for users doesn't help, please contact {% data variables.product.prodname_dotcom %} Support.
9898

99+
## Conflicting SAML identity error
100+
101+
{% data reusables.saml.conflicting-identity %}
102+
99103
## Further reading
100104

101105
* [AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/troubleshooting-identity-and-access-management-for-your-enterprise)

data/reusables/copilot/differences-cfi-cfb-table.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
| {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_windows_terminal %} | {% octicon "check" aria-label="Included" %} |{% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
1111
| {% data variables.product.prodname_copilot_cli_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
1212
| Block suggestions matching public code | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
13+
| {% data variables.product.prodname_copilot_short %} code review ({% data variables.release-phases.public_preview %}) | "Review selection" in {% data variables.product.prodname_vscode_shortname %} only | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
1314
| {% data variables.product.prodname_copilot_for_prs %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
1415
| {% data variables.product.prodname_copilot_chat_short %} skills in IDEs[^3] | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |
1516
| Exclude specified files from {% data variables.product.prodname_copilot_short %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} |

data/reusables/dependabot/supported-package-managers.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ poetry | `pip` | v1 | {% octicon "check" aria-l
3535
[pub](#pub) | `pub` | v2 | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% ifversion dependabot-updates-pub-private-registry %}{% octicon "check" aria-label="Supported" %}{% else %}{% octicon "x" aria-label="Not supported" %}{% endif %} | {% ifversion dependabot-updates-pub-private-registry %}{% octicon "check" aria-label="Supported" %}{% else %}{% octicon "x" aria-label="Not supported" %}{% endif %} | {% octicon "x" aria-label="Not supported" %} |
3636
[Swift](#swift) | `swift` | v5 | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} (git only) | {% octicon "x" aria-label="Not supported" %} |
3737
[Terraform](#terraform) | `terraform` | >= 0.13, <= 1.10.x | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | Not applicable |
38+
uv | `uv` | Not applicable | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | Not applicable |
3839
[yarn](#yarn) | `npm` | v1, v2, v3 | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %}|
3940

4041
> [!TIP]

0 commit comments

Comments
 (0)