1
0
mirror of synced 2025-12-22 03:16:52 -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

@@ -120,7 +120,7 @@ A fork is a copy of a repository that you manage, where any changes you make wil
### 2. Importing your projects ### 2. Importing your projects
If you have existing projects you'd like to move over to {% data variables.product.product_name %} you can import projects using the {% data variables.product.prodname_dotcom %} Importer, the command line, or external migration tools. For more information, see "[AUTOTITLE](/migrations/importing-source-code)." If you have existing projects you'd like to move over to {% data variables.product.product_name %} you can import projects using the {% data variables.product.prodname_importer %}, the command line, or external migration tools. For more information, see "[AUTOTITLE](/migrations/importing-source-code)."
### 3. Managing collaborators and permissions ### 3. Managing collaborators and permissions

View File

@@ -1,6 +1,6 @@
--- ---
title: Importing source code title: Importing source code
intro: "To import source code only, you can use{% ifversion fpt or ghec %} {% data variables.product.prodname_dotcom %} Importer or{% endif %} command line tools." intro: "To import source code only, you can use{% ifversion fpt or ghec %} {% data variables.product.prodname_importer %} or{% endif %} command line tools."
versions: versions:
fpt: '*' fpt: '*'
ghec: '*' ghec: '*'

View File

@@ -1,6 +1,6 @@
--- ---
title: About GitHub Importer 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: redirect_from:
- /articles/about-github-importer - /articles/about-github-importer
- /github/importing-your-projects-to-github/about-github-importer - /github/importing-your-projects-to-github/about-github-importer
@@ -11,9 +11,9 @@ versions:
ghec: '*' 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. 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 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: redirect_from:
- /articles/importing-from-other-version-control-systems-to-github - /articles/importing-from-other-version-control-systems-to-github
- /articles/importing-a-repository-with-github-importer - /articles/importing-a-repository-with-github-importer
@@ -13,9 +13,9 @@ versions:
shortTitle: Import a repository 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 %} {% 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)." 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**. 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 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: redirect_from:
- /get-started/importing-your-projects-to-github/importing-source-code-to-github - /get-started/importing-your-projects-to-github/importing-source-code-to-github
versions: versions:

View File

@@ -11,29 +11,29 @@ versions:
ghec: '*' ghec: '*'
shortTitle: Update commit authors 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 ## Updating commit authors
1. After you've imported your repository, on the import status page, click **Match 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. 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)." 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 ## 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 ## Further reading

View File

@@ -12,7 +12,7 @@ shortTitle: About source code imports
{% ifversion fpt or ghec %} {% ifversion fpt or ghec %}
If you want to import a Git repository that is stored on a code hosting service that is publicly available on the internet, we recommend using {% data variables.product.prodname_dotcom %} Importer. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer)." If you want to import a Git repository that is stored on a code hosting service that is publicly available on the internet, we recommend using {% data variables.product.prodname_importer %}. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer)."
If your source code is not tracked by Git or is not publicly available, you can use the command line instead. If your source code is not tracked by Git or is not publicly available, you can use the command line instead.

View File

@@ -90,7 +90,7 @@ Migrations from {% data variables.product.prodname_dotcom_the_website %} include
### Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_dotcom_the_website %} ### Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_dotcom_the_website %}
- **Scope**: Source and history - **Scope**: Source and history
- **Tooling**: Git CLI or GitHub Importer - **Tooling**: Git CLI or {% data variables.product.prodname_importer %}
- **More information**: - **More information**:
- "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)" - "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
- "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)" - "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"
@@ -118,7 +118,7 @@ Migrations from {% data variables.product.prodname_dotcom_the_website %} include
### Any Git repository to {% data variables.product.prodname_dotcom_the_website %} ### Any Git repository to {% data variables.product.prodname_dotcom_the_website %}
- **Scope**: Source and history - **Scope**: Source and history
- **Tooling**: Git CLI or GitHub Importer if the repository is accessible over the public internet - **Tooling**: Git CLI or {% data variables.product.prodname_importer %} if the repository is accessible over the public internet
- **More information**: - **More information**:
- "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)" - "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
- "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)" - "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"

View File

@@ -17,7 +17,7 @@ topics:
{% note %} {% note %}
**Note:** If you have a project hosted on another version control system, you can automatically import your project to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_dotcom %} Importer tool. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)." **Note:** If you have a project hosted on another version control system, you can automatically import your project to {% data variables.product.prodname_dotcom %} using the {% data variables.product.prodname_importer %} tool. For more information, see "[AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer)."
{% endnote %} {% endnote %}

View File

@@ -1,5 +1,5 @@
{% warning %} {% warning %}
**Warning**: Support for importing Mercurial, Subversion and Team Foundation Version Control (TFVC) repositories using {% data variables.product.prodname_dotcom %} Importer will end on April 12, 2024. For more information, see the [changelog](https://github.blog/changelog/2023-04-17-deprecation-importing-non-git-repositories-with-github-importer/). **Warning**: Support for importing Mercurial, Subversion and Team Foundation Version Control (TFVC) repositories using {% data variables.product.prodname_importer %} will end on April 12, 2024. For more information, see the [changelog](https://github.blog/changelog/2023-04-17-deprecation-importing-non-git-repositories-with-github-importer/).
{% endwarning %} {% endwarning %}

View File

@@ -263,6 +263,9 @@ prodname_command_palette: 'GitHub Command Palette'
# Server Statistics # Server Statistics
prodname_server_statistics: 'Server Statistics' prodname_server_statistics: 'Server Statistics'
# GitHub Importer
prodname_importer: 'GitHub Importer'
# GitHub Actions Importer # GitHub Actions Importer
prodname_actions_importer: 'GitHub Actions Importer' prodname_actions_importer: 'GitHub Actions Importer'