1
0
mirror of synced 2025-12-19 18:10:59 -05:00

[Improvement]: Create a product variable for "GitHub Importer" (#49359)

This commit is contained in:
Sophie
2024-02-26 09:46:21 +01:00
committed by GitHub
parent db102cdf6f
commit 6b0aab9ed5
11 changed files with 27 additions and 24 deletions

View File

@@ -1,6 +1,6 @@
---
title: About GitHub Importer
intro: "If your source code is stored on a code hosting service using Git, Subversion, Mercurial, or Team Foundation Version Control (TFVC) and is accessible from the public internet, you can move the code to {% data variables.product.prodname_dotcom %} using {% data variables.product.prodname_dotcom %} Importer."
intro: "If your source code is stored on a code hosting service using Git, Subversion, Mercurial, or Team Foundation Version Control (TFVC) and is accessible from the public internet, you can move the code to {% data variables.product.prodname_dotcom %} using {% data variables.product.prodname_importer %}."
redirect_from:
- /articles/about-github-importer
- /github/importing-your-projects-to-github/about-github-importer
@@ -11,9 +11,9 @@ versions:
ghec: '*'
---
## About {% data variables.product.prodname_dotcom %} Importer
## About {% data variables.product.prodname_importer %}
{% data variables.product.prodname_dotcom %} Importer is a tool that quickly imports source code repositories, including commits and revision history, to {% data variables.product.prodname_dotcom_the_website %} for you.
{% data variables.product.prodname_importer %} is a tool that quickly imports source code repositories, including commits and revision history, to {% data variables.product.prodname_dotcom_the_website %} for you.
During an import, depending on the version control system you're importing from, you can authenticate with your remote repository, update commit author attribution, and either import repositories with large files or, if you don't want to use {% data variables.large_files.product_name_long %}, remove large files.

View File

@@ -1,6 +1,6 @@
---
title: Importing a repository with GitHub Importer
intro: 'If you have a project hosted on another version control system, you can automatically import it to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_dotcom %} Importer tool.'
intro: 'If you have a project hosted on another version control system, you can automatically import it to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool.'
redirect_from:
- /articles/importing-from-other-version-control-systems-to-github
- /articles/importing-a-repository-with-github-importer
@@ -13,9 +13,9 @@ versions:
shortTitle: Import a repository
---
## About repository imports with {% data variables.product.prodname_dotcom %} Importer
## About repository imports with {% data variables.product.prodname_importer %}
{% data variables.product.prodname_dotcom %} Importer is not suitable for all imports. For example, if your existing code is hosted on a private network, our tool won't be able to access it. In these cases, we recommend [importing using the command line](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line) for Git repositories or an external [source code migration tool](/migrations/importing-source-code/using-the-command-line-to-import-source-code) for projects imported from other version control systems.
{% data variables.product.prodname_importer %} is not suitable for all imports. For example, if your existing code is hosted on a private network, our tool won't be able to access it. In these cases, we recommend [importing using the command line](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line) for Git repositories or an external [source code migration tool](/migrations/importing-source-code/using-the-command-line-to-import-source-code) for projects imported from other version control systems.
{% data reusables.migrations.github-importer-non-git-deprecation %}
@@ -25,9 +25,9 @@ If you'd like to match the commits in your repository to the authors' {% data va
For more information about migration paths to {% data variables.product.prodname_dotcom %} from other products, or between {% data variables.product.prodname_dotcom %} products, see "[AUTOTITLE](/migrations/overview/migration-paths-to-github)."
## Importing a repository with {% data variables.product.prodname_dotcom %} Importer
## Importing a repository with {% data variables.product.prodname_importer %}
When you import a repository using the {% data variables.product.prodname_dotcom %} Importer, a new repository will be created. If you already have an existing repository you want to use, you can instead add your local repository to {% data variables.product.prodname_dotcom %} using Git. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)."
When you import a repository using the {% data variables.product.prodname_importer %}, a new repository will be created. If you already have an existing repository you want to use, you can instead add your local repository to {% data variables.product.prodname_dotcom %} using Git. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)."
1. In the upper-right corner of any page, click {% octicon "plus" aria-label="Create new..." %}, and then click **Import repository**.

View File

@@ -1,6 +1,6 @@
---
title: Using GitHub Importer
intro: 'To import repositories that are publicly accessible, you can use GitHub Importer.'
intro: 'To import repositories that are publicly accessible, you can use {% data variables.product.prodname_importer %}.'
redirect_from:
- /get-started/importing-your-projects-to-github/importing-source-code-to-github
versions:

View File

@@ -11,29 +11,29 @@ versions:
ghec: '*'
shortTitle: Update commit authors
---
GitHub Importer looks for GitHub users whose email addresses match the authors of the commits in the repository you're importing. You can then connect a commit to its author using their email address or the author's GitHub username.
{% data variables.product.prodname_importer %} looks for {% data variables.product.prodname_dotcom %} users whose email addresses match the authors of the commits in the repository you're importing. You can then connect a commit to its author using their email address or the author's {% data variables.product.prodname_dotcom %} username.
## Updating commit authors
1. After you've imported your repository, on the import status page, click **Match authors**.
1. Next to the author whose information you'd like to update, click **Connect**.
1. Type the email address or GitHub username of the author, then press **Enter**.
1. Type the email address or {% data variables.product.prodname_dotcom %} username of the author, then press **Enter**.
## Attributing commits to a GitHub user with a public email address
## Attributing commits to a {% data variables.product.prodname_dotcom %} user with a public email address
If the author of a commit in your imported repository has a GitHub account associated with the email address they used to author the commits, and they haven't [set their commit email address as private](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address), GitHub Importer will match the email address associated with the commit to the public email address associated with their GitHub account, and attribute the commit to their GitHub account.
If the author of a commit in your imported repository has a {% data variables.product.prodname_dotcom %} account associated with the email address they used to author the commits, and they haven't [set their commit email address as private](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address), {% data variables.product.prodname_importer %} will match the email address associated with the commit to the public email address associated with their GitHub account, and attribute the commit to their {% data variables.product.prodname_dotcom %} account.
## Attributing commits to a GitHub user without a public email address
## Attributing commits to a {% data variables.product.prodname_dotcom %} user without a public email address
If the author of a commit in your imported repository has neither set a public email address on their GitHub profile, nor [set their commit email address as private](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address), GitHub Importer may not be able to match the email address associated with the commit with their GitHub account.
If the author of a commit in your imported repository has neither set a public email address on their {% data variables.product.prodname_dotcom %} profile, nor [set their commit email address as private](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address), {% data variables.product.prodname_importer %} may not be able to match the email address associated with the commit with their {% data variables.product.prodname_dotcom %} account.
The commit author can resolve this by setting their email address as private. Their commits will then be attributed to a no-reply email, and the imported commits will be associated with their GitHub account. For more information about the exact form the no-reply email address can take, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address)."
## Attributing commits using an email address
If the author's email address is not associated with their GitHub account, they can [add the address to their account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account) after the import, and the commits will be correctly attributed.
If the author's email address is not associated with their {% data variables.product.prodname_dotcom %} account, they can [add the address to their account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account) after the import, and the commits will be correctly attributed.
If the author does not have a GitHub account, GitHub Importer will attribute their commits to the email address associated with the commits.
If the author does not have a {% data variables.product.prodname_dotcom %} account, {% data variables.product.prodname_importer %} will attribute their commits to the email address associated with the commits.
## Further reading